Начало работы со входом в Google для iOS и macOS

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

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

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

Установите зависимости для входа в Google в свой проект.

Какао-стручки

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

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

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

    pod init

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

    pod 'GoogleSignIn'

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

    pod 'GoogleSignInSwiftSupport'

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

    pod install

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

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

Менеджер пакетов Swift

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

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

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

    Пакетный продукт GoogleВойтиSwift

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

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

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

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

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

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

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

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

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

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

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

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

Настройте проект приложения

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

Добавьте свой идентификатор клиента OAuth и собственную схему URL-адресов.

Обновите файл Info.plist вашего приложения, добавив идентификатор клиента OAuth и собственную схему URL-адресов на основе обратного идентификатора клиента .

Обратный идентификатор клиента — это ваш идентификатор клиента с обратным порядком полей, разделенных точками. Это также отображается в разделе « Схема URL-адресов iOS » при выборе существующего клиента iOS OAuth в облачной консоли . Например: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

Необязательно: настройка внутренней аутентификации.

Если вам нужно получить токены идентификаторов пользователей для внутренней аутентификации , также установите ключ GIDServerClientID в файле Info.plist вашего приложения.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

Необязательно: оптимизация для домена Google Workspace или области OpenID.

Используйте параметр GIDHostedDomain , если вы хотите оптимизировать процесс входа в домен Google Workspace.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

Используйте параметр GIDOpenIDRealm , если вы хотите указать область OpenID.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

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

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

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

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

,

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

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

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

Установите зависимости для входа в Google в свой проект.

Какао-стручки

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

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

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

    pod init

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

    pod 'GoogleSignIn'

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

    pod 'GoogleSignInSwiftSupport'

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

    pod install

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

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

Менеджер пакетов Swift

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

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

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

    Пакетный продукт GoogleВойтиSwift

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

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

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

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

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

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

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

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

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

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

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

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

Настройте проект приложения

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

Добавьте свой идентификатор клиента OAuth и собственную схему URL-адресов.

Обновите файл Info.plist вашего приложения, добавив идентификатор клиента OAuth и собственную схему URL-адресов на основе обратного идентификатора клиента .

Обратный идентификатор клиента — это ваш идентификатор клиента с обратным порядком полей, разделенных точками. Это также отображается в разделе « Схема URL-адресов iOS » при выборе существующего клиента iOS OAuth в облачной консоли . Например: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

Необязательно: настройка внутренней аутентификации.

Если вам нужно получить токены идентификаторов пользователей для внутренней аутентификации , также установите ключ GIDServerClientID в файле Info.plist вашего приложения.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

Необязательно: оптимизация для домена Google Workspace или области OpenID.

Используйте параметр GIDHostedDomain , если вы хотите оптимизировать процесс входа в домен Google Workspace.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

Используйте параметр GIDOpenIDRealm , если вы хотите указать область OpenID.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

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

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

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

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