Iniziare a utilizzare Accedi con Google per iOS e macOS

Prima di iniziare a integrare la tua app per iOS o macOS con i componenti di Accedi con Google, devi scaricare le dipendenze e configurare il progetto Xcode. I passaggi su in questa pagina. I passaggi successivi descrivono quindi come eseguire l'integrazione Funzionalità Accedi con Google nella tua app.

Prima di iniziare

Installa una versione attuale 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 guida.

  2. Apri una finestra del terminale e vai alla posizione del codice Xcode dell'app progetto.

  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 la sezione con Google" Pulsante: 

    pod 'GoogleSignInSwiftSupport'

  6. Salva il file ed esegui: 

    pod install

  7. Apri il file dell'area di lavoro .xcworkspace generato per la tua applicazione in Xcode. Utilizza questo file per lo sviluppo futuro della tua applicazione. (Nota che è diverso dal file .xcodeproj project incluso, che comporterebbe errori di generazione all'apertura.)

    Puoi consultare l'app di esempio Objective-C Podfile per vedere 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
    Confeziona il prodotto GoogleSignIn

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

    Confeziona il prodotto GoogleSignInSwift

Ottenere un ID client OAuth

La tua app richiede un ID client OAuth per identificarsi per l'autenticazione di Google di un backend cloud. Per le app per iOS e macOS, il tipo di applicazione con ID client OAuth. deve essere configurato come iOS.

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

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 nell'app. In via facoltativa, scarica il file di configurazione, che contiene l'ID client e altre di configurazione, come riferimento futuro.

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

Recuperare un ID client OAuth esistente

Ottenere un ID client del server OAuth

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

Per creare un ID client server:

  1. Apri il progetto nel Console Cloud.

  2. Crea un nuovo ID client OAuth di tipo applicazione web. Prendi nota delle la stringa ID client, che sarà necessaria per configurare Accedi con Google nel tuo dell'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. Facoltativamente, puoi anche aggiungere l'ID client server per autenticazione di backend o ottimizzare la tua app per i tuoi Workspace.

Aggiungi l'ID client OAuth e lo schema URL personalizzato

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

L'ID client invertito è il tuo ID client con l'ordine dei punti delimitato da punti campi invertiti. Questa opzione è visualizzata anche in "Schema URL iOS". quando selezioni un client OAuth per iOS esistente nel cloud 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 del backend

Se hai bisogno di conoscere Token ID per l'autenticazione 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 un'area di autenticazione OpenID

Utilizza il parametro GIDHostedDomain se vuoi ottimizzare il flusso di accesso per con 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 tua applicazione

Per essere pubblicata, la tua applicazione deve essere firmata con un certificato emesso da Apple in modo nativo sui dispositivi macOS e iOS al fine di memorizzare le credenziali tramite portachiavi.

Passaggi successivi

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