Google Login sur iOS

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.

Introduction

Dans ce guide, vous apprendrez à configurer l'authentification Google avec Capgo Social Login pour iOS. Je suppose que vous avez déjà lu le guide de configuration général.

Dans cette partie, vous apprendrez à configurer l'authentification Google sur iOS.

Créez un identifiant de client iOS dans le console Google
1. Cliquez sur la barre de recherche
2. Recherchez credentials et cliquez sur le APIs and Services un (le numéro 2 sur l'écran d'écran)
3. Cliquez sur le create credentials
4. Sélectionnez OAuth client ID
5. Sélectionnez le Application type à iOS
6. Trouvez l'ID de l'application
  1. Ouvrez Xcode
  2. Double-cliquez sur App
  3. Assurez-vous d'être sur Targets -> App
  4. Trouvez votre Bundle Identifier
  5. Retournez à la console Google et collez votre Bundle Identifier dans Bundle ID
7. Optionnellement, ajoutez votre App Store ID ou Team ID dans l'ID de client si vous avez publié votre application sur l'App Store
8. Après avoir rempli tous les détails, cliquez sur create
9. Cliquez OK
10. Ouvrez le client iOS créé récemment
11. Copiez les données suivantes
  
  Le nr. 1 dans cette image deviendra plus tard le iOSClientId dans le initialize appel.
  Le nr. 2 dans cette image deviendra plus tard YOUR_DOT_REVERSED_IOS_CLIENT_ID
Modifiez les informations de votre application Info.plist
1. Ouvrez Xcode et trouvez le Info.plist fichier
2. Appuyez sur le bouton droit sur ce fichier et ouvrez-le en source code
3. En bas de votre Plist fichier, vous verrez un </dict> tag
4. Insérez le fragment suivant juste avant le tag de fermeture </dict> Fichier Info.plist avec les schémas URL __CAPGO_KEEP_0__ insérés avant le tag de fermeture
```
<key>CFBundleURLTypes</key>
<array>
 <dict>
   <key>CFBundleURLSchemes</key>
   <array>
     <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
   </array>
 </dict>
</array>
```
5. à la valeur copiée dans l'étape précédente YOUR_DOT_REVERSED_IOS_CLIENT_ID Changer la valeur à la valeur copiée dans l'étape précédente.
  
  Vérifiez que cette valeur COMMENCE par com.googleusercontent.apps
6. Enregistrez le fichier avec Command + S

Modifiez le AppDelegate.swift

Ouvrez le fichier AppDelegate
Insérez import GoogleSignIn à la tête du fichier
Trouvez le func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) fonction

Modifiez la fonction pour qu'elle ressemble à ceci

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)
}

Fonction d'application modifiée openURL avec prise en charge de GoogleSignIn

Enregistrez le fichier avec Command + S

Configurer le login Google dans votre JavaScript/TypeScript code
1. Importer SocialLogin et Capacitor
```
import { SocialLogin } from '@capgo/capacitor-social-login';
import { Capacitor } from '@capacitor/core';
```
2. Appeler la méthode d'initialisation (ceci doit être appelé qu'une seule fois)
  
  Configuration de base (mode en ligne - recommandé pour la plupart des applications) :
```
// onMounted is Vue specific
onMounted(() => {
  SocialLogin.initialize({
    google: {
      iOSClientId: '673324426943-redacted.apps.googleusercontent.com',
      mode: 'online' // Default mode
    }
  })
})
```
  Configuration avancée avec des identifiants de client supplémentaires :
```
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'
    }
  })
})
```
  Remarque
  Exigences pour les identifiants de client :
  - iOSClientId: Obligatoire - Doit se terminer par googleusercontent.com (à partir de l'étape 1 ci-dessus)
  - webClientId: Facultatif - Seulement nécessaire si vous supportez également la plateforme web ou avez besoin de fonctionnalités avancées
  - iOSServerClientId: Optionnel - Doit être la même valeur que webClientId lorsque fourni
  Pour un setup avancé avec webClientId et iOSServerClientId, voir le guide de configuration web pour créer ces informations d'identification. Attention
  translations Lorsque vous utilisez mode: 'offline', la réponse de connexion ne contient pas les données utilisateur directement. Au lieu de cela, vous recevrez un authentification serveur code qui doit être échangé pour des informations d'utilisateur via votre serveur backend. SocialLogin.refresh({ provider: 'google' }) n'est pas disponible dans ce mode ; la mise à jour doit se produire sur votre serveur backend après l'échange serverAuthCode. Consultez le guide de configuration général pour les détails d'implémentation.
3. Implémentez la fonction de connexion. Créez un bouton et exécutez le code suivant code lors du clic
  
  Pour le mode en ligne :
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response - contains user data
console.log(JSON.stringify(res))
```
  Pour le mode hors ligne :
```
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)
```
Testez votre application
1. Construirez votre application et exécutez-la cap sync
2. Si vous avez fait tout correctement, vous devriez voir le flux de connexion Google fonctionner correctement

Problèmes connus

Incompatibilité du plugin de screen de confidentialité

Le plugin de connexion Google est incompatible avec @capacitor/écran-de-confidentialitéLorsque vous utilisez les deux plugins ensemble, la vue de connexion Google sera interrompue par l'écran de confidentialité.

Solution de contournement : Appeler await PrivacyScreen.disable(); avant d'appeler la fonction de connexion :

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

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

Si vous utilisez Google Login sur iOS pour planifier l'authentification et les flux de compte, connectez-le à En utilisant @capgo/capacitor-social-login pour la capacité native en utilisant En utilisant @capgo/capacitor-social-login, @capgo/capacitor-connexion sociale pour les détails d'implémentation dans @capgo/capacitor-connexion sociale, @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, @capgo/capacitor-authentification biométrique native pour les détails d'implémentation dans @capgo/capacitor-authentification biométrique native, et L'authentification à deux facteurs pour les détails d'implémentation dans L'authentification à deux facteurs.