Nesta página, mostramos como integrar o Login do Google a um app para iOS ou macOS. Talvez seja necessário adaptar estas instruções ao ciclo de vida ou ao modelo de interface do seu app.
Antes de começar
Faça o download das dependências, configure o projeto do Xcode e defina o ID do cliente.
Teste nosso app de exemplo para iOS e macOS para entender 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
:
Swift
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
}
Objective-C
- (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
No AppDelegate do seu app, registre um gerenciador para eventos
kAEGetURL
emapplicationDidFinishLaunching
: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]; }
Defina o gerenciador desses eventos que chama o
handleURL
doGIDSignIn
: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 no cenário do seu app, registre um gerenciador para receber o URL e chamar
handleURL
s de GIDSignIn
:
Swift
@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 seu 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 tenham que fazer login sempre que abrirem o app, a menos que tenham saído da conta.
Os apps iOS geralmente fazem isso no método
application:didFinishLaunchingWithOptions:
do UIApplicationDelegate
e
no applicationDidFinishLaunching:
do NSApplicationDelegate
para apps para macOS. Use
o resultado para determinar qual visualização apresentar ao usuário. Exemplo:
Swift
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
}
Objective-C
- (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 a SwiftUI, adicione uma chamada para restorePreviousSignIn
em onAppear
para
a visualização inicial:
Swift
@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" à visualização de login. Estão disponíveis componentes para o SwiftUI e UIKit que geram automaticamente um botão com a marca do Google e são recomendados para uso.
Como usar o SwiftUI
Confira se você adicionou a dependência do botão "Fazer login com o Google" do SwiftUI ao projeto.
No arquivo em que você quer adicionar o botão do SwiftUI, adicione a importação necessária na parte de cima:
import GoogleSignInSwift
Adicione um botão "Fazer login com o Google" à sua visualização e especifique a ação que será chamada quando o botão for pressionado:
GoogleSignInButton(action: handleSignInButton)
Acione o processo de login quando o botão for pressionado, adicionando uma chamada ao método
signIn(presentingViewController:completion:)
deGIDSignIn
na sua ação:func handleSignInButton() { GIDSignIn.sharedInstance.signIn( withPresenting: rootViewController) { signInResult, error in guard let result = signInResult else { // Inspect error return } // If sign in succeeded, display the app's main content View. } ) }
Isso usa o modelo de visualização padrão que fornece informações de estilo padrão para
o botão. Para controlar a aparência do botão, crie um GoogleSignInButtonViewModel
personalizado e o defina como viewModel
no inicializador
do botão usando GoogleSignInButton(viewModel: yourViewModel, action:
yourAction)
. Consulte o código-fonte GoogleSignInButtonViewModel
para saber mais.
Como usar o UIKit
Adicione um botão "Fazer login com o Google" à visualização de login. É possível usar a classe
GIDSignInButton
para gerar automaticamente um botão com a marca do Google (recomendado) ou criar seu próprio botão com estilo personalizado.Para adicionar um
GIDSignInButton
a um storyboard ou arquivo XIB, inclua uma visualização e defina a classe personalizada comoGIDSignInButton
. Quando você adiciona uma visualizaçãoGIDSignInButton
ao storyboard, o botão de login não é renderizado no criador de interface. Execute o app para conferir o botão de login.Você pode personalizar a aparência de um
GIDSignInButton
definindo as propriedadescolorScheme
estyle
:Propriedades de estilo do GIDSignInButton colorScheme
kGIDSignInButtonColorSchemeLight
kGIDSignInButtonColorSchemeDark
style
kGIDSignInButtonStyleStandard
kGIDSignInButtonStyleWide
kGIDSignInButtonStyleIconOnly
Conecte o botão a um método no ViewController que chame
signIn:
. Por exemplo, use umIBAction
:Swift
@IBAction func signIn(sender: Any) { GIDSignIn.sharedInstance.signIn(withPresenting: self) { signInResult, error in guard error == nil else { return } // If sign in succeeded, display the app's main content View. } }
Objective-C
- (IBAction)signIn:(id)sender { [GIDSignIn.sharedInstance signInWithPresentingViewController:self completion:^(GIDSignInResult * _Nullable signInResult, NSError * _Nullable error) { if (error) { return; } // If sign in succeeded, display the app's main content View. }]; }
4. Adicionar um botão para sair
Adicione um botão para sair do app, visível para os usuários conectados.
Conecte o botão a um método no ViewController que chame
signOut:
. Por exemplo, use umIBAction
: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 app usando as Contas do Google deles, saiba como:
- Receber informações do perfil da Conta do Google dos usuários.
- Faça a autenticação com seu back-end usando o token de ID do Google do usuário.
- Chame APIs do Google em nome do usuário.