iOS 또는 macOS 앱에 Google 로그인 통합

이 페이지에서는 Google 로그인을 iOS 또는 macOS 앱에 통합하는 방법을 설명합니다. 이러한 지침을 앱의 수명 주기 또는 UI 모델에 맞게 조정해야 할 수 있습니다.

시작하기 전에

종속 항목을 다운로드하고 Xcode 프로젝트를 구성하고 클라이언트 ID를 설정합니다.

iOS 및 macOS 샘플 앱을 사용하여 로그인 작동 방식을 알아보세요.

1. 인증 리디렉션 URL 처리

iOS: UIApplicationDelegate

AppDelegate의 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
}

- (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. 앱의 AppDelegate에서 kAEGetURL 이벤트에 대한 핸들러를 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. 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:

@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: 사용 결과를 사용하여 사용자에게 표시할 뷰를 결정합니다. 예를 들면 다음과 같습니다.

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

SwiftUI를 사용하는 경우 onAppear에 restorePreviousSignIn 호출을 추가합니다. 초기 보기:

@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 브랜딩으로 표시되며 사용을 권장합니다.

4. 로그아웃 버튼 추가

1. 로그인한 사용자에게 표시되는 로그아웃 버튼을 앱에 추가합니다.

2. ViewController에서 메서드를 호출하는 signOut: 예를 들어 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를 호출합니다.