На этой странице показано, как интегрировать Google Sign-In в приложение для iOS или macOS. Вам может потребоваться адаптировать эти инструкции для жизненного цикла вашего приложения или модели пользовательского интерфейса.
Прежде чем вы начнете
Загрузите зависимости, настройте свой проект Xcode и установите свой идентификатор клиента .
1. Обработка URL-адреса перенаправления аутентификации
iOS: UIApplicationDelegate
В вашем application:openURL:options
вызовите метод GIDSignIn
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
}
Цель-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
В AppDelegate вашего приложения зарегистрируйте обработчик событий
kAEGetURL
вapplicationDidFinishLaunching
:Быстрый
func applicationDidFinishLaunching(_ notification: Notification) { // Register for GetURL events. let appleEventManager = NSAppleEventManager.shared() appleEventManager.setEventHandler( self, andSelector: "handleGetURLEvent:replyEvent:", forEventClass: AEEventClass(kInternetEventClass), andEventID: AEEventID(kAEGetURL) ) }
Цель-C
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification { // Register for GetURL events. NSAppleEventManager *appleEventManager = [NSAppleEventManager sharedAppleEventManager]; [appleEventManager setEventHandler:self andSelector:@selector(handleGetURLEvent:withReplyEvent:) forEventClass:kInternetEventClass andEventID:kAEGetURL]; }
Определите обработчик для этих событий, который вызывает
handleURL
GIDSignIn
:Быстрый
func handleGetURLEvent(event: NSAppleEventDescriptor?, replyEvent: NSAppleEventDescriptor?) { if let urlString = event?.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue{ let url = NSURL(string: urlString) GIDSignIn.sharedInstance.handle(url) } }
Цель-C
- (void)handleGetURLEvent:(NSAppleEventDescriptor *)event withReplyEvent:(NSAppleEventDescriptor *)replyEvent { NSString *URLString = [[event paramDescriptorForKeyword:keyDirectObject] stringValue]; NSURL *URL = [NSURL URLWithString:URLString]; [GIDSignIn.sharedInstance handleURL:url]; }
SwiftUI
В окне или сцене вашего приложения зарегистрируйте обработчик для получения URL-адреса и вызовите GIDSignIn
handleURL
:
Быстрый
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
// ...
.onOpenURL { url in
GIDSignIn.sharedInstance.handle(url)
}
}
}
}
2. Попытка восстановить состояние входа пользователя
Когда ваше приложение запустится, вызовите restorePreviousSignInWithCallback
, чтобы попытаться восстановить состояние входа пользователей, которые уже вошли в систему с помощью Google. Это гарантирует, что пользователям не придется входить в систему каждый раз, когда они открывают ваше приложение (если они не вышли из системы).
Приложения iOS часто делают это в методе UIApplicationDelegate
application:didFinishLaunchingWithOptions:
и applicationDidFinishLaunching:
NSApplicationDelegate
для приложений macOS. Используйте результат, чтобы определить, какое представление представить пользователю. Например:
Быстрый
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
}
Цель-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
Если вы используете SwiftUI, добавьте вызов restorePreviousSignIn
в onAppear
для первоначального представления:
Быстрый
@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. Добавьте кнопку входа в Google
Добавьте кнопку «Войти с помощью Google» в окно входа. Для SwiftUI и UIKit доступны компоненты, которые автоматически генерируют кнопку с логотипом Google и рекомендуются к использованию.
Использование SwiftUI
Убедитесь, что вы добавили зависимость для кнопки SwiftUI «Войти через Google» в свой проект.
В файле, куда вы хотите добавить кнопку SwiftUI, добавьте нужный импорт в начало файла:
import GoogleSignInSwift
Добавьте кнопку «Войти через Google» в свой вид и укажите действие, которое будет вызываться при нажатии кнопки:
GoogleSignInButton(action: handleSignInButton)
Запустите процесс входа при нажатии кнопки, добавив вызов метода
signIn(presentingViewController:completion:)
GIDSignIn
в действие: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. } ) }
При этом используется модель представления по умолчанию, которая предоставляет стандартную информацию о стиле для кнопки. Чтобы управлять внешним видом кнопки, вам нужно создать пользовательскую модель GoogleSignInButtonViewModel
и установить ее в качестве viewModel
в инициализаторе кнопки с помощью GoogleSignInButton(viewModel: yourViewModel, action: yourAction)
. Дополнительные сведения см. в исходном коде GoogleSignInButtonViewModel
.
Использование UIKit
Добавьте кнопку «Войти с помощью Google» в окно входа. Вы можете использовать класс
GIDSignInButton
для автоматического создания кнопки с фирменной символикой Google (рекомендуется) или создать собственную кнопку с пользовательским стилем.Чтобы добавить
GIDSignInButton
в файл раскадровки или XIB, добавьте представление и задайте для его пользовательского класса значениеGIDSignInButton
. Обратите внимание, что когда вы добавляете представлениеGIDSignInButton
в свою раскадровку, кнопка входа не отображается в построителе интерфейса. Запустите приложение, чтобы увидеть кнопку входа.Вы можете настроить внешний вид
GIDSignInButton
, установив его свойстваcolorScheme
иstyle
:Свойства стиля GIDSignInButton colorScheme
kGIDSignInButtonColorSchemeLight
kGIDSignInButtonColorSchemeDark
style
kGIDSignInButtonStyleStandard
kGIDSignInButtonStyleWide
kGIDSignInButtonStyleIconOnly
Подключите кнопку к методу в вашем ViewController, который вызывает
signIn:
. Например, используйтеIBAction
:Быстрый
@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. } }
Цель-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. Добавьте кнопку выхода
Добавьте кнопку выхода в свое приложение, видимую для вошедших пользователей.
Подключите кнопку к методу в вашем ViewController, который вызывает
signOut:
. Например, используйтеIBAction
:Быстрый
@IBAction func signOut(sender: Any) { GIDSignIn.sharedInstance.signOut() }
Цель-C
- (IBAction)signOut:(id)sender { [GIDSignIn.sharedInstance signOut]; }
Следующие шаги
Теперь, когда пользователи могут входить в ваше приложение, используя свои аккаунты Google, узнайте, как:
- Получите информацию о профилях аккаунтов Google пользователей .
- Выполните аутентификацию в своем бэкэнде, используя токен Google ID пользователя.
- Вызов API Google от имени пользователя.