Integrazione di Accedi con Google nell'app per iOS o macOS

Questa pagina mostra come integrare Accedi con Google in un'app per iOS o macOS. Potresti dover adattare queste istruzioni al ciclo di vita o al modello di UI della tua app.

Prima di iniziare

Scarica le dipendenze, configura il progetto Xcode e imposta il tuo ID client.

Prova la nostra app di esempio per iOS e macOS per vedere come funziona l'accesso.

1. Gestire l'URL di reindirizzamento di autenticazione

iOS: UIApplicationDelega

Nel metodo application:openURL:options di AppDelegato, chiama GIDSignIn Metodo handleURL::

func application(
  _ app: UIApplication,
  open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]
) -> Bool {
  var handled: Bool

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

  // Handle other custom URL types.

  // If not handled by this app, return false.
  return false
}

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
  BOOL handled;

  handled = [GIDSignIn.sharedInstance handleURL:url];
  if (handled) {
    return YES;
  }

  // Handle other custom URL types.

  // If not handled by this app, return NO.
  return NO;
}

macOS: NSApplicationDelegate

1. Nel campo AppDelegato dell'app, registra un gestore per gli eventi kAEGetURL in applicationDidFinishLaunching:

   Swift

   func applicationDidFinishLaunching(_ notification: Notification) {
     // Register for GetURL events.
     let appleEventManager = NSAppleEventManager.shared()
     appleEventManager.setEventHandler(
       self,
       andSelector: "handleGetURLEvent:replyEvent:",
       forEventClass: AEEventClass(kInternetEventClass),
       andEventID: AEEventID(kAEGetURL)
     )
   }
   

   Objective-C

   - (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
     // Register for GetURL events.
     NSAppleEventManager *appleEventManager = [NSAppleEventManager sharedAppleEventManager];
     [appleEventManager setEventHandler:self
                        andSelector:@selector(handleGetURLEvent:withReplyEvent:)
                        forEventClass:kInternetEventClass
                        andEventID:kAEGetURL];
   }
   

2. Definisci il gestore per questi eventi che chiama handleURL di GIDSignIn:

   Swift

   func handleGetURLEvent(event: NSAppleEventDescriptor?, replyEvent: NSAppleEventDescriptor?) {
       if let urlString =
         event?.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue{
           let url = NSURL(string: urlString)
           GIDSignIn.sharedInstance.handle(url)
       }
   }
   

   Objective-C

   - (void)handleGetURLEvent:(NSAppleEventDescriptor *)event
              withReplyEvent:(NSAppleEventDescriptor *)replyEvent {
         NSString *URLString = [[event paramDescriptorForKeyword:keyDirectObject] stringValue];
         NSURL *URL = [NSURL URLWithString:URLString];
         [GIDSignIn.sharedInstance handleURL:url];
   }
   

SwiftUI

Nella finestra o nella scena dell'app, registra un gestore per ricevere l'URL e chiamare GIDSignIn handleURL:

@main
struct MyApp: App {

  var body: some Scene {
    WindowGroup {
      ContentView()
        // ...
        .onOpenURL { url in
          GIDSignIn.sharedInstance.handle(url)
        }
    }
  }
}

2. Tentativo di ripristinare lo stato di accesso dell'utente

Quando la tua app si avvia, chiama il numero restorePreviousSignInWithCallback per provare e ripristinare lo stato di accesso degli utenti che hanno già eseguito l'accesso utilizzando Google. In questo modo garantisce che gli utenti non debbano eseguire l'accesso ogni volta che aprono la tua app (a meno che l'utente è uscito).

Le app per iOS spesso lo fanno in UIApplicationDelegate application:didFinishLaunchingWithOptions: e applicationDidFinishLaunching: di NSApplicationDelegate per le app macOS. Utilizza le funzionalità di il risultato per stabilire quale vista presentare all'utente. Ad esempio:

func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
  GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
    if error != nil || user == nil {
      // Show the app's signed-out state.
    } else {
      // Show the app's signed-in state.
    }
  }
  return true
}

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [GIDSignIn.sharedInstance restorePreviousSignInWithCompletion:^(GIDGoogleUser * _Nullable user,
                                                                  NSError * _Nullable error) {
    if (error) {
      // Show the app's signed-out state.
    } else {
      // Show the app's signed-in state.
    }
  }];
  return YES;
}

SwiftUI

Se utilizzi SwiftUI, aggiungi una chiamata a restorePreviousSignIn in onAppear per visualizzazione iniziale:

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        // ...
        .onAppear {
          GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
            // Check if `user` exists; otherwise, do something with `error`
          }
        }
    }
  }
}

3. Aggiungi un pulsante Accedi con Google

Aggiungere un'opzione "Accedi con Google" alla vista di accesso. Sono disponibili componenti per SwiftUI e UIKit che generano automaticamente con brand Google e sono consigliati per l'uso.

4. Aggiungi un pulsante di disconnessione

1. Aggiungi alla tua app un pulsante di disconnessione, visibile agli utenti che hanno eseguito l'accesso.

2. Collega il pulsante a un metodo nel tuo ViewController che chiama signOut:. Ad esempio, utilizza un IBAction:

   Swift

   @IBAction func signOut(sender: Any) {
     GIDSignIn.sharedInstance.signOut()
   }
   

   Objective-C

   - (IBAction)signOut:(id)sender {
     [GIDSignIn.sharedInstance signOut];
   }
   

Passaggi successivi

Ora che gli utenti possono accedere alla tua app con i propri Account Google, scopri come a:

• Attira l'attenzione degli utenti Dati del profilo dell'Account Google.
• Esegui l'autenticazione con il tuo backend utilizzando l'ID Google dell'utente. di accesso.
• Chiamare le API di Google per conto dell'utente.