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
Se non hai ancora installato CocoaPods, segui i passaggi nella Guida introduttiva di CocoaPods guida.
Apri una finestra del terminale e vai alla posizione del codice Xcode dell'app progetto.
Se non hai ancora creato un Podfile per la tua applicazione, creane uno ora:
pod init
Apri il podfile creato per l'applicazione e aggiungi quanto segue:
pod 'GoogleSignIn'
Se utilizzi SwiftUI, aggiungi anche l'estensione pod per la sezione con Google" Pulsante:
pod 'GoogleSignInSwiftSupport'
Salva il file ed esegui:
pod install
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
Apri il progetto in Xcode.
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 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.
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:
Apri il progetto nel Console Cloud.
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.