Começar a usar o Login do Google para iOS e macOS

Antes de começar a integrar o app iOS ou macOS aos componentes do Login do Google, faça o download das dependências e configure o projeto Xcode. As etapas em esta página faz exatamente isso. As próximas etapas descrevem como fazer a integração recursos de Login do Google no seu app.

Antes de começar

Instale uma versão atual do Xcode.

Instalar as dependências do Login do Google no seu projeto

CocoaPods

  1. Se você ainda não tiver o CocoaPods instalado, siga as etapas descritas na Primeiros passos do CocoaPods guia.

  2. Abra uma janela do terminal e navegue até o local do Xcode do seu app. projeto.

  3. Se você ainda não criou um Podfile para seu aplicativo, crie um agora: 

    pod init

  4. Abra o Podfile criado para seu aplicativo e adicione o seguinte: 

    pod 'GoogleSignIn'

  5. Se você estiver usando SwiftUI, adicione também a extensão do pod para a seção com o Google" botão: 

    pod 'GoogleSignInSwiftSupport'

  6. Salve o arquivo e execute: 

    pod install

  7. Abra o arquivo .xcworkspace workspace gerado para seu app em Xcode. Use esse arquivo em todos os desenvolvimentos futuros do aplicativo. (Observação que é diferente do arquivo de projeto .xcodeproj incluído, que resultaria em erros de versão quando abertos.)

    Consulte a API Objective-C Podfile como exemplo.

Gerenciador de pacotes do Swift

  1. Abra seu projeto no Xcode.

  2. Adicionar as dependências de Login do Google ao seu app (Documentação do Xcode):

    Repositório https://github.com/google/GoogleSignIn-iOS
    Versão 7.0.0
    Produto do pacote GoogleSignIn

  3. Se você estiver usando SwiftUI, adicione também o seguinte produto de pacote de extensão para a opção "Fazer login com o Google" botão:

    Produto do pacote GoogleSignInSwift

Receber um ID do cliente OAuth

Seu app precisa de um ID do cliente OAuth para se identificar na autenticação do Google. back-end. Em apps iOS e macOS, o tipo de aplicativo do ID do cliente OAuth. precisa estar configurado como iOS.

Se você ainda não tiver criado um ID do cliente OAuth, clique no botão abaixo para fazer isso.

Criar um ID do cliente OAuth

Depois de criar o ID do cliente OAuth, anote a string do ID do cliente, que você precisa configurar o Login do Google no seu app. Também é possível faça o download do arquivo de configuração, que contém o ID do cliente e outros e os dados de configuração para referência futura.

Se você já tiver criado um ID do cliente OAuth, poderá encontrar o ID do OAuth atual. clicando no botão abaixo.

Receber um ID do cliente OAuth

Receber um ID do cliente do servidor OAuth

A maioria dos apps precisa transmitir a identidade dos usuários conectados para um serviço de back-end de algum tipo. Para transmitir com segurança a identidade dos usuários que fizeram login com o Google ao back-end, use tokens de ID, conforme discutido em Autenticar com um servidor de back-end. Recuperar o token de ID de um usuário exige um segundo ID do cliente: seu servidor ID do cliente, que representa seu back-end.

Para criar um ID do cliente do servidor:

  1. Abra seu projeto no Console do Cloud:

  2. Crie um novo ID do cliente OAuth do tipo Aplicativo da Web. Confira as string de ID do cliente, que você precisará para configurar o Login do Google na sua app.

Configurar o projeto do aplicativo

O Login do Google exige que o projeto seja configurado com o ID do cliente OAuth e um esquema de URL personalizado. Também é possível adicionar seu ID do cliente do servidor para autenticação de back-end ou otimizar seu app para a Workspace.

Adicionar o ID do cliente OAuth e o esquema de URL personalizado

Atualize o arquivo Info.plist do app para adicionar o OAuth ID do cliente e um esquema de URL personalizado com base no ID do cliente invertido.

O ID do cliente invertido é seu ID de cliente com a ordem do caractere delimitado por ponto campos invertidos. Ele também aparece em Esquema de URL do iOS. ao selecionar um cliente OAuth do iOS atual no Cloud no console do Google Cloud. Exemplo: 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>

Opcional: configurar a autenticação de back-end

Se você precisa conseguir tokens de ID para autenticação de back-end; defina também a chave GIDServerClientID no arquivo Info.plist do app.

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

Opcional: otimizar para um domínio do Google Workspace ou domínio do OpenID

Use o parâmetro GIDHostedDomain se você quiser otimizar o fluxo de login para um domínio do Google Workspace.

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

Use o parâmetro GIDOpenIDRealm se quiser especificar um domínio OpenID.

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

Assinar o aplicativo

Seu aplicativo precisa ser assinado com um certificado emitido pela Apple para ser executado nativamente em dispositivos macOS e iOS para armazenar credenciais por meio do chaveiro.

Próximas etapas

Agora que você fez o download das dependências do projeto e configurou seu Xcode, projeto, adicione o Login do Google ao seu app iOS.