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

이 페이지에서는 Google 로그인을 iOS 또는 macOS 앱에 통합하는 방법을 설명합니다. 이러한 지침을 앱의 수명 주기 또는 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

  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:

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 사용

  1. SwiftUI 'Google 계정으로 로그인' 종속 항목을 추가했는지 확인합니다. 버튼 프로젝트에 추가합니다

  2. SwiftUI 버튼을 추가하려는 파일에서 파일 상단에 필요한 가져오기를 추가합니다.

    import GoogleSignInSwift

  3. 'Google 계정으로 로그인' 추가 버튼을 추가하고 작업을 가 호출될 때 발생합니다.

    GoogleSignInButton(action: handleSignInButton)

  4. 버튼을 누르면 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 사용

  1. 'Google 계정으로 로그인' 추가 로그인 보기로 이동합니다. 이 Google로 버튼을 자동으로 생성하는 GIDSignInButton 클래스 브랜딩 (권장)을 사용하거나 맞춤 스타일을 지정하여 버튼을 직접 만들 수 있습니다.

    GIDSignInButton를 스토리보드 또는 XIB 파일에 추가하려면 뷰를 추가하고 커스텀 클래스를 GIDSignInButton로 설정합니다. 참고: GIDSignInButton 스토리보드에 표시할 때 로그인 버튼이 렌더링되지 않습니다. 인터페이스 빌더에서 확인할 수 있습니다. 앱을 실행하여 로그인 버튼을 확인합니다.

    다음과 같이 설정하여 GIDSignInButton의 모양을 맞춤설정할 수 있습니다. colorScheme 및 style 속성:

    GIDSignInButton 스타일 속성
    colorScheme kGIDSignInButtonColorSchemeLight
    kGIDSignInButtonColorSchemeDark
    style kGIDSignInButtonStyleStandard
    kGIDSignInButtonStyleWide
    kGIDSignInButtonStyleIconOnly

  2. ViewController에서 메서드를 호출하는 signIn: 예를 들어 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. 로그아웃 버튼 추가

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

  2. ViewController에서 메서드를 호출하는 signOut: 예를 들어 IBAction를 사용합니다.

    Swift

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

    Objective-C

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

다음 단계

이제 사용자가 Google 계정을 사용하여 앱에 로그인할 수 있습니다. 방법을 알아보세요. 다음과 같이 변경합니다.