Integrar o Login do Google no seu app para iOS ou macOS

Nesta página, mostramos como integrar o Login do Google a um app iOS ou macOS. Talvez seja necessário adaptar essas instruções ao ciclo de vida ou ao modelo de UI do seu app.

Antes de começar

Faça o download das dependências, configure seu projeto Xcode e defina o ID do cliente.

Teste nosso app de exemplo para iOS e macOS e veja como o Login funciona.

1. Processar o URL de redirecionamento de autenticação

iOS: UIApplicationDelegate

No método application:openURL:options do AppDelegate, chame o método handleURL: do GIDSignIn:

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. No AppDelegate do seu app, registre um gerenciador para eventos kAEGetURL em 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. Defina o manipulador desses eventos que chama o handleURL do 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

Na janela ou cena do app, registre um gerenciador para receber o URL e chame GIDSignIns handleURL:

@main
struct MyApp: App {

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

2. Tentar restaurar o estado de login do usuário

Quando o app for iniciado, chame restorePreviousSignInWithCallback para tentar restaurar o estado de login dos usuários que já fizeram login usando o Google. Isso garante que os usuários não precisem fazer login toda vez que abrem o app, a menos que tenham feito logout.

Os apps iOS costumam fazer isso no método application:didFinishLaunchingWithOptions: de UIApplicationDelegate e no applicationDidFinishLaunching: de NSApplicationDelegate para apps macOS. Use o resultado para determinar qual visualização apresentar ao usuário. Exemplo:

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 você estiver usando o SwiftUI, adicione uma chamada para restorePreviousSignIn em onAppear para sua visualização 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. Adicionar um botão de Login do Google

Adicione um botão "Fazer login com o Google" à sua visualização de login. Os componentes estão disponíveis para SwiftUI e UIKit, geram automaticamente um botão com a marca do Google e são recomendados para uso.

4. Adicionar um botão de logout

1. Adicione um botão de logout ao app, visível para usuários conectados.

2. Conecte o botão a um método no ViewController que chama signOut:. Por exemplo, use um IBAction:

   Swift

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

   Objective-C

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

Próximas etapas

Agora que os usuários podem fazer login no seu app usando as Contas do Google, saiba como:

• Acesse as informações de perfil da Conta do Google dos usuários.
• Autentique com seu back-end usando o token de ID do Google do usuário.
• Chamar as APIs do Google em nome do usuário.