このページでは、iOS または macOS アプリに Google ログインを統合する方法について説明します。アプリのライフサイクルまたは UI モデルに合わせて、以下の手順を調整する必要がある場合があります。
始める前に
依存関係をダウンロードし、Xcode プロジェクトを構成して、クライアント ID を設定します。
iOS と macOS のサンプルアプリを試して、ログインの仕組みをご確認ください。
1. 認証リダイレクト URL を処理する
iOS: UIApplicationDelegate
AppDelegate の application:openURL:options メソッドで、GIDSignIn の handleURL: メソッドを呼び出します。
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
アプリの AppDelegate で、
applicationDidFinishLaunchingのkAEGetURLイベントのハンドラを登録します。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]; }GIDSignInのhandleURLを呼び出す、これらのイベントのハンドラを定義します。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
アプリのウィンドウまたはシーンで、URL を受信して GIDSignIn の handleURL を呼び出すハンドラを登録します。
Swift
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
// ...
.onOpenURL { url in
GIDSignIn.sharedInstance.handle(url)
}
}
}
}
2. ユーザーのログイン状態の復元を試みる
アプリの起動時に restorePreviousSignInWithCallback を呼び出して、Google
を使用してすでにログインしているユーザーのログイン状態の復元を試みます。これにより、ユーザーはアプリを開くたびにログインする必要がなくなります(ログアウトした場合を除く)。
iOS アプリでは、UIApplicationDelegate の application:didFinishLaunchingWithOptions: メソッドで、macOS アプリでは NSApplicationDelegate の
applicationDidFinishLaunching:
メソッドでこれを行うことがよくあります。結果を使用して、ユーザーに表示するビューを決定します。次に例を示します。
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
SwiftUI を使用している場合は、最初のビューの onAppear に restorePreviousSignIn の呼び出しを追加します。
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. Google ログインボタンを追加する
ログインビューに [Google でログイン] ボタンを追加します。 SwiftUI と UIKit で使用できるコンポーネントがあり、Google ブランドのボタンが自動的に生成されるため、使用することをおすすめします。
SwiftUI を使用する
SwiftUI ボタンを追加するファイルの先頭に、必要な import を追加します。
import GoogleSignInSwiftビューに [Google でログイン] ボタンを追加し、ボタンが押されたときに呼び出されるアクションを指定します。
GoogleSignInButton(action: handleSignInButton)アクションで
GIDSignInのsignIn(presentingViewController:completion:)メソッドの呼び出しを追加して、ボタンが押されたときにログイン プロセスをトリガーします。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 のスタイル プロパティ colorSchemekGIDSignInButtonColorSchemeLight
kGIDSignInButtonColorSchemeDarkstylekGIDSignInButtonStyleStandard
kGIDSignInButtonStyleWide
kGIDSignInButtonStyleIconOnlyボタンを、
signIn:を呼び出す ViewController のメソッドに接続します。たとえば、IBActionを使用します。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. ログアウトボタンを追加する
ログインしているユーザーに表示されるログアウトボタンをアプリに追加します。
ボタンを、
signOut:を呼び出す ViewController のメソッドに接続します。たとえば、IBActionを使用します。Swift
@IBAction func signOut(sender: Any) { GIDSignIn.sharedInstance.signOut() }Objective-C
- (IBAction)signOut:(id)sender { [GIDSignIn.sharedInstance signOut]; }
次のステップ
ユーザーが Google アカウントを使用してアプリにログインできるようになったので、次の方法について学習します。
- ユーザーの Google アカウントのプロフィール情報を取得する。
- ユーザーの Google ID トークンを使用してバックエンドで認証する。
- Google API をユーザーに代わって呼び出す。