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 di Accesso Google, devi scaricare le dipendenze e configurare il progetto Xcode. I passaggi riportati in questa pagina fanno proprio questo. I passaggi successivi descrivono come integrare le funzionalità di Accesso Google nella tua app.

Prima di iniziare

Installa una versione aggiornata di Xcode.

Installa le dipendenze di Accesso Google nel tuo progetto

CocoaPods

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

    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 workspace .xcworkspace generato per la tua applicazione in Xcode. Utilizza questo file per lo sviluppo futuro dell'applicazione. Tieni presente che questo è diverso dal file .xcodeproj project incluso, che causerebbe 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 all'app (documentazione di Xcode):

    Repository https://github.com/google/GoogleSignIn-iOS
    Versione 7.0.0
    Imballare il prodotto GoogleSignIn

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

    Imballare 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 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.

Recuperare un ID client OAuth esistente

Ottenere un ID client del 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. Per recuperare il token ID di un utente è necessario un secondo ID client, ovvero l'ID client del server, che rappresenta il tuo backend.

Per creare un ID client del server:

  1. Apri il progetto nella console Cloud.

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

Configura il progetto dell'applicazione

Accedi con Google richiede la configurazione del progetto con l'ID client OAuth e uno schema URL personalizzato. Se vuoi, puoi anche aggiungere l'ID client del 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 cliente invertito è il tuo ID cliente con l'ordine dei campi delimitati da punti invertito. Viene visualizzato anche in "Schema URL per 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 gli ID token 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) Ottimizzazione 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>

Firma dell'applicazione

L'applicazione deve essere firmata con un certificato emesso da Apple per essere eseguita in modo nativo su dispositivi macOS e iOS al fine di memorizzare 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.