Iniziare a utilizzare Accedi con Google per iOS e macOS

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 tuo progetto Xcode. I passaggi in questa pagina 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.

Installa le dipendenze di Accedi con Google nel tuo progetto

CocoaPods

  1. Se non hai ancora installato CocoaPods, segui i passaggi nella 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 ora:

    pod init

  4. Apri il Podfile creato per l'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 .xcworkspace workspace generato per l'applicazione in Xcode. Utilizzare questo file per lo sviluppo futuro dell'applicazione. Tieni presente che questo file è diverso dal file progetto .xcodeproj incluso, che all'apertura causerebbe errori di build.

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

Gestore 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 7.0.0
    Confezionare il prodotto GoogleSignIn
  3. Se utilizzi SwiftUI, aggiungi anche il seguente prodotto per il pacchetto di estensioni per il pulsante "Accedi con Google":

    Confezionare il prodotto 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 ID client OAuth deve essere configurato come iOS.

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

Creare un ID client OAuth

Dopo aver creato l'ID client OAuth, prendi nota della stringa dell'ID client, che dovrai utilizzare per configurare Accedi con Google nell'app. Se vuoi, 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 qui sotto.

Ottieni un ID client OAuth esistente

Ottenere un ID client server OAuth

La maggior parte delle app deve trasferire l'identità degli utenti che hanno eseguito l'accesso a un qualche tipo di servizio di backend. Per passare in modo sicuro l'identità degli utenti che hanno eseguito l'accesso con Google al tuo backend, puoi utilizzare 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 l'ID client server, che rappresenta il 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, necessaria per configurare Accedi con Google nella tua app.

Configura il progetto dell'applicazione

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

Aggiungi il tuo 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 invertito. Questo errore viene visualizzato anche in "Schema URL iOS" quando selezioni un client OAuth per 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) Configura l'autenticazione del backend

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

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

(Facoltativo) Ottimizza per un dominio Google Workspace o per un'area di autenticazione OpenID

Utilizza il parametro GIDHostedDomain per 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>

Firma della richiesta in corso...

Per poter archiviare le credenziali tramite il portachiavi, l'applicazione deve essere firmata con un certificato emesso da Apple per l'esecuzione in modo nativo su dispositivi macOS e iOS.

Passaggi successivi

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