iOS 및 macOS용 Google 로그인 시작하기

iOS 또는 macOS 앱을 Google 로그인 구성요소와 통합하려면 먼저 종속 항목을 다운로드하고 Xcode 프로젝트를 구성해야 합니다. 이 페이지의 단계를 따르세요. 다음 단계에서는 Google 로그인 기능을 앱에 통합하는 방법을 설명합니다.

시작하기 전에

최신 버전의 Xcode를 설치합니다.

프로젝트에 Google 로그인 종속 항목 설치

CocoaPods

  1. 아직 CocoaPods를 설치하지 않았다면 CocoaPods 시작하기 가이드의 단계를 따르세요.

  2. 터미널 창을 열고 앱의 Xcode 프로젝트 위치로 이동합니다.

  3. 애플리케이션의 Podfile을 아직 만들지 않았다면 지금 만듭니다. 

    pod init

  4. 애플리케이션용으로 만든 Podfile을 열고 다음을 추가합니다. 

    pod 'GoogleSignIn'

  5. SwiftUI를 사용하는 경우 'Google 계정으로 로그인' 버튼의 pod 확장 프로그램도 추가합니다. 

    pod 'GoogleSignInSwiftSupport'

  6. 파일을 저장하고 다음 명령어를 실행하세요. 

    pod install

  7. Xcode에서 애플리케이션에 대해 생성된 .xcworkspace 작업공간 파일을 엽니다. 향후 애플리케이션의 모든 개발 작업에 이 파일을 사용하세요. 이는 포함된 .xcodeproj 프로젝트 파일과 다르며, 이 파일을 열면 빌드 오류가 발생합니다.

    예를 보려면 Objective-C 샘플 앱의 Podfile을 참고하세요.

Swift Package Manager

  1. Xcode에서 프로젝트를 엽니다.

  2. 앱에 Google 로그인 종속 항목을 추가합니다(Xcode 문서).

    저장소 https://github.com/google/GoogleSignIn-iOS
    버전 7.0.0
    패키지 제품 GoogleSignIn

  3. SwiftUI를 사용하는 경우 'Google 계정으로 로그인' 버튼의 다음 확장 프로그램 패키지 제품도 추가합니다.

    패키지 제품 GoogleSignInSwift

OAuth 클라이언트 ID 가져오기

앱이 Google의 인증 백엔드에 자신을 식별하려면 OAuth 클라이언트 ID가 필요합니다. iOS 및 macOS 앱의 경우 OAuth 클라이언트 ID 애플리케이션 유형을 iOS로 구성해야 합니다.

아직 OAuth 클라이언트 ID를 만들지 않았다면 아래 버튼을 클릭하여 만드세요.

OAuth 클라이언트 ID 만들기

OAuth 클라이언트 ID를 만든 후 앱에서 Google 로그인을 구성하는 데 필요한 클라이언트 ID 문자열을 메모합니다. 원하는 경우 나중에 참고할 수 있도록 클라이언트 ID 및 기타 구성 데이터가 포함된 구성 파일을 다운로드할 수 있습니다.

이미 OAuth 클라이언트 ID를 만든 경우 아래 버튼을 클릭하여 기존 OAuth 정보를 확인할 수 있습니다.

기존 OAuth 클라이언트 ID 가져오기

OAuth 서버 클라이언트 ID 가져오기

대부분의 앱은 로그인한 사용자의 ID를 일종의 백엔드 서비스에 전달해야 합니다. Google 계정으로 로그인한 사용자의 ID를 백엔드로 안전하게 전달하려면 백엔드 서버에서 인증에 설명된 대로 ID 토큰을 사용합니다. 사용자의 ID 토큰을 검색하려면 백엔드를 나타내는 두 번째 클라이언트 ID(서버 클라이언트 ID)가 필요합니다.

서버 클라이언트 ID를 만들려면 다음 단계를 따르세요.

  1. Cloud Console에서 프로젝트를 엽니다.

  2. 새 웹 애플리케이션 유형 OAuth 클라이언트 ID를 만듭니다. 앱에서 Google 로그인을 구성하는 데 필요한 클라이언트 ID 문자열을 기록해 둡니다.

애플리케이션 프로젝트 구성

Google 로그인을 사용하려면 프로젝트가 OAuth 클라이언트 ID 및 맞춤 URL 스키마로 구성되어야 합니다. 원하는 경우 백엔드 인증을 위해 서버 클라이언트 ID를 추가하거나 Google Workspace 도메인에 맞게 앱을 최적화할 수도 있습니다.

OAuth 클라이언트 ID 및 맞춤 URL 스키마 추가

앱의 Info.plist 파일을 업데이트하여 OAuth 클라이언트 ID와 반전된 클라이언트 ID를 기반으로 맞춤 URL 스키마를 추가합니다.

역순 클라이언트 ID는 점으로 구분된 필드의 순서가 역순으로 된 클라이언트 ID입니다. Cloud 콘솔에서 기존 iOS OAuth 클라이언트를 선택할 때 'iOS URL 스키마'에도 표시됩니다. 예: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

선택사항: 백엔드 인증 구성

백엔드 인증을 위해 사용자의 ID 토큰을 가져와야 하는 경우 앱의 Info.plist 파일에서 GIDServerClientID 키도 설정합니다.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

선택사항: Google Workspace 도메인 또는 OpenID 영역에 맞게 최적화

Google Workspace 도메인의 로그인 흐름을 최적화하려면 GIDHostedDomain 매개변수를 사용하세요.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

OpenID 영역을 지정하려면 GIDOpenIDRealm 매개변수를 사용하세요.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

애플리케이션 서명

키체인을 통해 사용자 인증 정보를 저장하려면 macOS 및 iOS 기기에서 네이티브로 실행되도록 애플에서 발급한 인증서로 애플리케이션을 서명해야 합니다.

다음 단계

이제 프로젝트 종속 항목을 다운로드하고 Xcode 프로젝트를 구성했으므로 iOS 앱에 Google 로그인을 추가할 수 있습니다.