Guida introduttiva di Accedi con Google per iOS e macOS

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di poter iniziare a integrare la tua app per iOS o macOS con i componenti Accedi con Google, devi scaricare le dipendenze e configurare il progetto Xcode. I passaggi disponibili in questa pagina sono stati eseguiti. Nei passaggi successivi descrivi come integrare le funzionalità Accedi con Google nella tua app.

Prima di iniziare

Installa una versione attuale di Xcode.

Installa le dipendenze Accedi con Google nel progetto

CocoaPods

  1. Se non hai ancora installato CocoaPods, segui la procedura della Guida introduttiva di CocoaPods.

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

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

    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 pod per il pulsante "Accedi con Google": 

    pod 'GoogleSignInSwiftSupport'

  6. Salva il file ed esegui: 

    pod install

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

    Per un esempio, puoi fare riferimento al podfile dell'app di esempio Objective-C.

Gestione pacchetti Swift

  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 6,0,2
    Pacco del prodotto Accedi con Google

  3. Se usi SwiftUI, aggiungi anche il seguente pacchetto di estensioni per il pulsante "Accedi con Google":

    Pacco del prodotto Accedi con Google

Ottieni un ID client OAuth

La tua app richiede un ID client OAuth per identificarsi nel backend di autenticazione di Google. Per le app 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 seguente per farlo.

Creare un ID client OAuth

Dopo aver creato l'ID client OAuth, prendi nota della stringa dell'ID client, che dovrai configurare Accedi con Google nella tua app. Se lo desideri, puoi scaricare il file di configurazione, che contiene il tuo 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.

Ottieni un ID client OAuth esistente

Ottieni un ID client server OAuth

La maggior parte delle app dovrà trasferire 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 a 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, ovvero il tuo ID client server, che rappresenta il tuo backend.

Per creare un ID client server:

  1. Apri il tuo progetto in Cloud Console.

  2. Crea un nuovo ID client OAuth di tipo Applicazione web. Prendi nota della stringa dell'ID client, che dovrai configurare per accedere a Google nella tua app.

Configura il progetto dell'applicazione

La funzionalità Accedi con Google richiede la configurazione del progetto con l'ID client OAuth e uno schema di URL personalizzati. Facoltativamente, puoi anche aggiungere il tuo ID client server per l'autenticazione backend o ottimizzare la tua app per il tuo dominio Google Workspace.

Aggiungere l'ID client OAuth e lo schema URL personalizzato

Aggiorna il file Info.plist dell'app per aggiungere il tuo 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 invertiti. Questa operazione viene mostrata anche in "Schema URL iOS" quando selezioni un client OAuth per iOS esistente nella console Google 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: configura l'autenticazione backend

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

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

(Facoltativo) Ottimizza: un dominio Google Workspace o l'area di autenticazione 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'area di autenticazione OpenID.

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

Firmare l'applicazione

L'applicazione deve essere firmata con un certificato emesso da Apple per essere eseguito in modo nativo sui dispositivi macOS e iOS per archiviare le credenziali tramite il portachiavi.

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.