Iniziare a utilizzare Accedi con Google per iOS e macOS

Prima di poter iniziare a integrare l'app per iOS o macOS con i componenti di Accedi con Google, devi scaricare le dipendenze e configurare il progetto Xcode. I passaggi descritti in questa pagina ti consentono di farlo. I passaggi successivi descrivono come integrare le funzionalità di Accedi con Google nella tua app.

Prima di iniziare

Installa una versione corrente di Xcode.

Installare le dipendenze di Accedi con Google nel progetto

CocoaPods

  1. Se non hai ancora installato CocoaPods, segui i passaggi descritti nella guida introduttiva di CocoaPods.

  2. Apri una finestra del terminale e accedi alla posizione del progetto Xcode della tua app.

  3. Se non hai ancora creato un Podfile per la tua applicazione, creane uno ora: 

    pod init

  4. Apri il Podfile creato per la tua applicazione e aggiungi quanto segue: 

    pod 'GoogleSignIn'

  5. Se utilizzi SwiftUI, aggiungi anche l'estensione del pod per il pulsante "Accedi con Google": 

    pod 'GoogleSignInSwiftSupport'

  6. Salva il file ed esegui: 

    pod install

  7. Apri il file .xcworkspace workspace generato per la tua applicazione in Xcode. Utilizza questo file per lo sviluppo futuro dell'applicazione. (Tieni presente che è diverso dal file .xcodeproj project incluso, che genererebbe errori di compilazione se aperto.)

    Puoi fare riferimento al Podfile dell'app di esempio Objective-C per un esempio.

Swift Package Manager

  1. Apri il progetto in Xcode.

  2. Aggiungi le dipendenze di Accedi con Google alla tua app (documentazione di Xcode):

    Repository https://github.com/google/GoogleSignIn-iOS
    Versione 9.0.0
    Prodotto del pacchetto GoogleSignIn

  3. Se utilizzi SwiftUI, aggiungi anche il seguente prodotto del pacchetto di estensione per il pulsante "Accedi con Google":

    Prodotto del pacchetto GoogleSignInSwift

Ottenere un ID client OAuth

La tua app ha bisogno di un ID client OAuth per identificarsi nel backend di autenticazione di Google. Per le app per iOS e macOS, il tipo di applicazione dell'ID client OAuth deve essere configurato come iOS.

Se non hai ancora creato un ID client OAuth, fai clic sul pulsante di seguito per farlo.

Creare un ID client OAuth

Dopo aver creato l'ID client OAuth, prendi nota della stringa dell'ID client, che ti servirà per configurare Accedi con Google nella tua app. Se vuoi, puoi scaricare il file di configurazione, che contiene l'ID client e altri dati di configurazione, per riferimento futuro.

Se hai già creato un ID client OAuth, puoi trovare le informazioni OAuth esistenti facendo clic sul pulsante di seguito.

Ottenere un ID client OAuth esistente

Ottenere un ID client server OAuth

La maggior parte delle app dovrà trasmettere l'identità degli utenti che hanno eseguito l'accesso a un servizio di backend di qualche tipo. Per trasmettere in modo sicuro l'identità degli utenti che hanno eseguito l'accesso con Google al tuo backend, utilizza i token ID, come descritto in Autenticarsi con un server di backend. Il recupero del token ID di un utente richiede un secondo ID client, l'ID client server, che rappresenta il tuo backend.

Per creare un ID client server:

  1. Apri il progetto nella console Cloud.

  2. Crea un nuovo ID client OAuth di tipo Applicazione web. Prendi nota della stringa dell'ID client, che ti servirà per configurare Accedi con Google nella tua app.

Configurare il progetto dell'applicazione

Accedi con Google richiede che il progetto sia configurato con l'ID client OAuth e uno schema URL personalizzato. Se vuoi, puoi anche aggiungere l'ID client server per l'autenticazione del backend o ottimizzare l'app per il tuo dominio Google Workspace.

Aggiungere l'ID client OAuth e lo schema URL personalizzato

Aggiorna il file Info.plist della tua app per aggiungere l'ID client OAuth e uno schema URL personalizzato basato sull'ID client invertito.

L'ID client invertito è l'ID client con l'ordine dei campi delimitati da punti invertito. Viene visualizzato anche in "Schema URL iOS" quando selezioni un ID client OAuth iOS esistente nella console Cloud. Ad esempio: 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>

(Facoltativo) Configurare l'autenticazione del backend

Se devi ottenere i token ID degli utenti per l'autenticazione del backend, imposta anche la chiave GIDServerClientID nel file Info.plist della tua app.

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

(Facoltativo) Ottimizzare per un dominio Google Workspace o un realm OpenID

Utilizza il parametro GIDHostedDomain se vuoi ottimizzare il flusso di accesso per un dominio Google Workspace.

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

Utilizza il parametro GIDOpenIDRealm se vuoi specificare un realm OpenID.

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

Firmare l'applicazione

Per archiviare le credenziali utilizzando Keychain, l'applicazione deve essere firmata con un certificato rilasciato da Apple per essere eseguita in modo nativo su dispositivi macOS e iOS.

Affinché l'app per macOS possa archiviare correttamente le credenziali utilizzando Keychain, devi anche aggiungere $(AppIdentifierPrefix)$(CFBundleIdentifier) al gruppo di accesso Keychain.

Passaggi successivi

Ora che hai scaricato le dipendenze del progetto e configurato il progetto Xcode, puoi aggiungere Accedi con Google alla tua app per iOS.