Login Google su iOS

Copia una riga di comando con le istruzioni di installazione e la guida markdown completa per questo plugin.

Introduzione

In questa guida, imparerai a configurare il login con Google con Capgo Social Login per iOS. Assumo che tu abbia già letto il Guida di configurazione generale.

In questo capitolo, imparerai a configurare il login Google su iOS.

Crea un ID client iOS nel console di Google
1. Clicca sulla barra di ricerca
2. Cerca credentials e clicca sul APIs and Services uno (numero 2 nella schermata)
3. Clicca sull'opzione create credentials
4. Seleziona OAuth client ID
5. Seleziona il Application type per iOS
6. Trova l'ID del bundle
  1. Apri Xcode
  2. Doppio clic su App
  3. Assicurati di essere su Targets -> App
  4. Trova il tuo Bundle Identifier
  5. Torna indietro al Console di Google e incolla il tuo Bundle Identifier nel Bundle ID
7. Opzionalmente, aggiungi il tuo App Store ID o Team ID nel campo ID client se hai pubblicato il tuo app su App Store
8. Dopo aver riempito tutti i dettagli, clicca create
9. Clicca OK
10. Apri il nuovo client iOS creato
11. Copia i seguenti dati
  
  Il nr. 1 in questa immagine diventerà in seguito il iOSClientId in il initialize chiamata.
  Il nr. 2 in questa immagine diventerà in seguito YOUR_DOT_REVERSED_IOS_CLIENT_ID
Modifica l'elenco delle informazioni del tuo app
1. Apre Xcode e trova il Info.plist file
2. Clicca con il tasto destro su questo file e apriolo come fonte code
3. Alla fine del tuo Plist file, vedrai un </dict> tag
4. Inserisci il seguente frammento prima del tag di chiusura </dict> tag di chiusura
```
<key>CFBundleURLTypes</key>
<array>
 <dict>
   <key>CFBundleURLSchemes</key>
   <array>
     <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
   </array>
 </dict>
</array>
```
5. Cambia il YOUR_DOT_REVERSED_IOS_CLIENT_ID in il valore copiato nel passo precedente
  
  Assicurati che questo valore INIZI con com.googleusercontent.apps
6. Salva il file con Command + S

Modifica il AppDelegate.swift

Apri il file AppDelegate.swift nel navigatore del progetto Xcode
Inserisci import GoogleSignIn in cima al file
Trova la func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) funzione

Modifica la funzione per assomigliare a questa

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    // Called when the app was launched with a url. Feel free to add additional processing here,
    // but if you want the App API to support tracking app url opens, make sure to keep this call

    var handled: Bool

    handled = GIDSignIn.sharedInstance.handle(url)
    if handled {
      return true
    }

    return ApplicationDelegateProxy.shared.application(app, open: url, options: options)
}

La funzione di apertura dell'applicazione modificata con gestione di GoogleSignIn

Salva il file con Command + S

Configura il login Google nel tuo JavaScript/TypeScript code
1. Importa SocialLogin e Capacitor
```
import { SocialLogin } from '@capgo/capacitor-social-login';
import { Capacitor } from '@capacitor/core';
```
2. Chiamare il metodo di inizializzazione (questo dovrebbe essere chiamato solo una volta)
  
  Configurazione base (modalità online - consigliata per la maggior parte degli app):
```
// onMounted is Vue specific
onMounted(() => {
  SocialLogin.initialize({
    google: {
      iOSClientId: '673324426943-redacted.apps.googleusercontent.com',
      mode: 'online' // Default mode
    }
  })
})
```
  Configurazione avanzata con ID client aggiuntivi:
```
onMounted(() => {
  SocialLogin.initialize({
    google: {
      webClientId: 'YOUR_WEB_CLIENT_ID',           // Optional: for web platform support
      iOSClientId: 'YOUR_IOS_CLIENT_ID',           // Required: from step 1
      iOSServerClientId: 'YOUR_WEB_CLIENT_ID',     // Optional: same as webClientId, needed for some advanced features
      mode: 'online'                               // 'online' or 'offline'
    }
  })
})
```
  Nota
  Requisiti per l'ID del client:
  - iOSClientId: Richiesto - Deve concludersi con googleusercontent.com (dal passaggio 1 sopra)
  - webClientId: Facoltativo - Serve solo se si supporta anche la piattaforma web o si hanno bisogno di funzionalità avanzate
  - iOSServerClientId: Facoltativo - Dovrebbe avere lo stesso valore di webClientId quando fornito
  Per impostazioni avanzate con webClientId e iOSServerClientId, vedere la guida di impostazione web web setup guide per la creazione di questi credenziali.
  Informazioni sull'accesso offline: Quando si utilizza mode: 'offline', la risposta di accesso non conterrà i dati dell'utente direttamente. Invece, riceverai un'autenticazione del server code che deve essere scambiata per informazioni sull'utente tramite il tuo server backend. SocialLogin.refresh({ provider: 'google' }) non è disponibile in questo modo; il refresh deve avvenire sul tuo backend dopo lo scambio di serverAuthCodeVedi il guida di configurazione generale per i dettagli di implementazione.
3. Implementa la funzione di accesso. Crea un pulsante e esegui il seguente code al click
  
  Per il modo online:
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response - contains user data
console.log(JSON.stringify(res))
```
  Per il modalità offline:
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {
    forceRefreshToken: true // Recommended for offline mode
  }
})
// res contains serverAuthCode, not user data
// Send serverAuthCode to your backend to get user information
// Do not call SocialLogin.refresh() in offline mode
console.log('Server auth code:', res.result.serverAuthCode)
```
Testa il tuo'applicazione
1. Costruisci il tuo'app e eseguilo cap sync
2. Se hai fatto tutto correttamente, dovresti vedere il flusso di accesso Google che funziona correttamente

Problemi noti

Incompatibilità del plugin di schermo di privacy

Il plugin di accesso Google è incompatibile con @capacitor/privacy-screen. Quando si utilizzano entrambi i plugin insieme, il webview di accesso Google verrà interrotto dallo schermo di privacy.

Soluzione di contorno: Chiamata await PrivacyScreen.disable(); prima di chiamare la funzione di accesso:

import { PrivacyScreen } from '@capacitor/privacy-screen';
import { SocialLogin } from '@capgo/capacitor-social-login';

await PrivacyScreen.disable();
await SocialLogin.login({
  provider: 'google',
  options: {}
});

Se si utilizza Google Login su iOS per pianificare l'autenticazione e le flussi di account, connettilo con Usando @capgo/capacitor-login-social per la capacità nativa in Usando @capgo/capacitor-login-social, @capgo/capacitor-login-social per il dettaglio di implementazione in @capgo/capacitor-login-social, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-biometria-nativa per il dettaglio di implementazione in @capgo/capacitor-biometria-nativa, e Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori.