Integrar el Acceso con Google en tu app para iOS o macOS

En esta página, se muestra cómo integrar el Acceso con Google en una app para iOS o macOS. Es posible que debas adaptar estas instrucciones al ciclo de vida de tu app o al modelo de IU.

Antes de comenzar

Descarga las dependencias, configura tu proyecto de Xcode y establece tu ID de cliente.

Prueba nuestra app de ejemplo de iOS y macOS para ver cómo funciona el Acceso.

1. Controla la URL de redireccionamiento de autenticación

iOS: UIApplicationDelegate

En el método application:openURL:options de AppDelegate, llama al método GIDSignIn Método 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. En el AppDelegate de tu app, registra un controlador para los eventos kAEGetURL en 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. Define el controlador para estos eventos que llama al handleURL de 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

En la ventana o escena de tu app, registra un controlador para recibir la URL y llamar handleURL de GIDSignIn:

@main
struct MyApp: App {

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

2. Intentar restablecer el estado de acceso del usuario

Cuando se inicie tu app, llama a restorePreviousSignInWithCallback para probar lo siguiente: restablecer el estado de acceso de los usuarios que ya accedieron con Google. Hacerlo garantiza que los usuarios no deban acceder cada vez que abran tu app (a menos que salió de la cuenta).

Las apps para iOS suelen hacer esto en la carpeta UIApplicationDelegate método application:didFinishLaunchingWithOptions: y applicationDidFinishLaunching: de NSApplicationDelegate para apps de macOS. Usa el resultado para determinar qué vista presentar al usuario. Por ejemplo:

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

Si usas SwiftUI, agrega una llamada a restorePreviousSignIn en onAppear para tu vista inicial:

@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. Agrega un botón de Acceso con Google

Agrega un permiso de "Acceder con Google" a la Vista de acceso. Hay componentes disponibles para SwiftUI y UIKit que generan automáticamente un con la marca de Google y se recomienda su uso.

4. Agrega un botón para salir

1. Agrega un botón para salir a tu app, que sea visible para los usuarios que accedieron.

2. Conecta el botón a un método en tu ViewController que llame a signOut: Por ejemplo, usa un IBAction:

   Swift

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

   Objective-C

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

Próximos pasos

Ahora que los usuarios pueden acceder a tu app con sus Cuentas de Google, obtén información sobre cómo a:

• Obtén datos de los usuarios Información del perfil de la Cuenta de Google
• Autentica con tu backend mediante el ID de Google del usuario token.
• Llamar a las APIs de Google en nombre del usuario