Login Google su iOS

Copiare un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Introduzione

In questo guide, imparerai a configurare l'accesso Google con Capgo Social Login per iOS. Assumo che tu abbia già letto la guida di configurazione generale.

In questo capitolo, imparerai a configurare il login di 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 sul create credentials
4. Seleziona OAuth client ID
5. Seleziona il Application type per iOS
6. Trova l'ID del bundle
  1. Apri Xcode
  2. Clicca due volte su App
  3. Assicurati di essere su Targets -> App
  4. Trova il tuo Bundle Identifier
  5. Torna al Console di Google e incolla il tuo Bundle Identifier in Bundle ID
7. Se desiderato, 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. OK sul dialogo di conferma dell'ID client creato OK
10. __CAPGO_KEEP_0__
11. Copia i dati seguenti
  
  In questo immagine diventerà il nr. 1 in questo iOSClientId chiamata. initialize In questo immagine diventerà il
  Modifica il file Info.plist della tua app nr. 2 in questo YOUR_DOT_REVERSED_IOS_CLIENT_ID
chiamata.
1. Apri Xcode e trova il file Info.plist file
2. Fai clic destro su questo file e apriolo come fonte code
3. In fondo al tuo Plist file, vedrai una </dict> etichetta
4. Inserisci il seguente frammento prima della chiusura </dict> Etichetta di chiusura del dizionario in Info.plist con schemi URL __CAPGO_KEEP_0__ inseriti prima della 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 INIZIA con com.googleusercontent.apps
6. Salva il file con Command + S

Modifica il AppDelegate.swift

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

Modifica la funzione per farla 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)
}

Funzione di apertura dell'applicazione modificata con gestione di GoogleSignIn

Salva il file con Command + S

Configura il login con 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 (dalla step 1 sopra)
  - webClientId: Facoltativo - È necessario solo se si supporta anche la piattaforma web o si richiedono funzionalità avanzate
  - iOSServerClientId: Facoltativo - Dovrebbe avere lo stesso valore di webClientId quando fornito
  Per una configurazione avanzata con webClientId e iOSServerClientId, vedere la guida di configurazione web per la creazione di questi credenziali. per la creazione di questi credenziali.
  Informazioni sulle modalità offline: Quando si utilizza mode: 'offline'il risposta di accesso non conterrà i dati dell'utente direttamente. Invece, riceverai un'autenticazione del server code che deve essere scambiato per informazioni sull'utente tramite il tuo server backend. SocialLogin.refresh({ provider: 'google' }) non è disponibile in questa modalità; il refresh deve avvenire sul tuo server backend dopo aver scambiato 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 la modalità online:
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response - contains user data
console.log(JSON.stringify(res))
```
  Per 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 la tua applicazione
1. Costruisci l'applicazione e eseguila cap sync
2. Se hai fatto tutto correttamente, dovresti vedere il flusso di accesso Google che funziona correttamente

Problemi noti

Incompatibilità del plugin della schermata di accesso alle informazioni personali

Il plugin di accesso Google è incompatibile con @capacitor/privacy-screenQuando si utilizzano entrambi i plugin insieme, la schermata di login webview di Google verrà interrotta dalla schermata di privacy.

Soluzione alternativa: Chiamare await PrivacyScreen.disable(); prima di chiamare la funzione di login:

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

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