Начните работу с Google Sign-In для iOS и macOS

Прежде чем вы сможете начать интеграцию своего приложения iOS или macOS с компонентами Google Sign-In, вы должны загрузить зависимости и настроить свой проект Xcode. Шаги на этой странице делают именно это. Следующие шаги описывают, как интегрировать функции Google Sign-In в ваше приложение.

Прежде чем вы начнете

Установите текущую версию Xcode .

Установите зависимости Google Sign-In в своем проекте.

CocoaPods

  1. Если вы еще не установили CocoaPods, выполните действия, описанные в руководстве по началу работы с CocoaPods.

  2. Откройте окно терминала и перейдите к расположению проекта Xcode вашего приложения.

  3. Если вы еще не создали подфайл для своего приложения, создайте его сейчас:

    pod init

  4. Откройте Podfile, созданный для вашего приложения, и добавьте следующее:

    pod 'GoogleSignIn'

  5. Если вы используете SwiftUI, также добавьте расширение модуля для кнопки «Войти с помощью Google»:

    pod 'GoogleSignInSwiftSupport'
    .

  6. Сохраните файл и запустите:

    pod install

  7. Откройте сгенерированный файл рабочей области .xcworkspace для вашего приложения в Xcode. Используйте этот файл для всех будущих разработок вашего приложения. (Обратите внимание, что он отличается от включенного файла проекта .xcodeproj , который может привести к ошибкам сборки при открытии.)

    В качестве примера вы можете обратиться к подфайлу примера приложения Objective-C .

Быстрый менеджер пакетов

  1. Откройте свой проект в Xcode.

  2. Добавьте зависимости Google Sign-In в свое приложение ( документация Xcode ):

    Репозиторий https://github.com/google/GoogleSignIn-iOS
    Версия 6.0.2
    Пакетный продукт GoogleВход
  3. Если вы используете SwiftUI, также добавьте следующий продукт пакета расширения для кнопки «Войти с помощью Google»:

    Пакетный продукт GoogleSignInSwift

Получить идентификатор клиента OAuth

Вашему приложению требуется идентификатор клиента OAuth, чтобы идентифицировать себя в серверной части аутентификации Google. Для приложений iOS и macOS тип приложения идентификатора клиента OAuth должен быть настроен как iOS.

Если вы еще не создали идентификатор клиента OAuth, нажмите кнопку ниже, чтобы сделать это.

Создайте идентификатор клиента OAuth

После создания идентификатора клиента OAuth запишите строку идентификатора клиента, которая потребуется для настройки входа через Google в вашем приложении. При желании вы можете загрузить файл конфигурации, который содержит ваш идентификатор клиента и другие данные конфигурации, для дальнейшего использования.

Если вы уже создали идентификатор клиента OAuth, вы можете найти существующую информацию об OAuth, нажав кнопку ниже.

Получить существующий идентификатор клиента OAuth

Получить идентификатор клиента сервера OAuth

Большинству приложений потребуется передать удостоверение вошедших пользователей какой-либо серверной службе. Чтобы безопасно передать удостоверение пользователей, которые вошли в систему с помощью Google, на ваш сервер, вы используете токены идентификатора, как обсуждалось в разделе Аутентификация с внутренним сервером . Для получения токена идентификатора пользователя требуется второй идентификатор клиента — идентификатор клиента вашего сервера , — который представляет ваш сервер.

Чтобы создать идентификатор клиента сервера:

  1. Откройте свой проект в облачной консоли .

  2. Создайте новый идентификатор клиента OAuth типа веб-приложения . Обратите внимание на строку идентификатора клиента, которая потребуется для настройки входа через Google в вашем приложении.

Добавьте схему URL для входа через Google в свой проект

Для входа в Google требуется, чтобы в ваш проект была добавлена ​​настраиваемая схема URL-адресов. Чтобы добавить пользовательскую схему:

  1. Откройте конфигурацию вашего проекта: дважды щелкните имя проекта в левом древовидном представлении. Выберите свое приложение в разделе ЦЕЛИ , затем перейдите на вкладку Информация и разверните раздел Типы URL .

  2. Нажмите кнопку + и добавьте свой обратный идентификатор клиента в качестве схемы URL.

    Обратный идентификатор клиента — это ваш идентификатор клиента с обратным порядком полей, разделенных точками. Например:

    com.googleusercontent.apps.1234567890-abcdefg

По завершении ваша конфигурация должна выглядеть примерно так (но со значениями, специфичными для вашего приложения):

Подписание вашего приложения

Ваше приложение должно быть подписано с помощью сертификата, выданного Apple, для работы на устройствах macOS и iOS, чтобы хранить учетные данные через цепочку ключей.

Следующие шаги

Теперь, когда вы загрузили зависимости проекта и настроили проект Xcode, вы можете добавить вход через Google в свое приложение для iOS.