이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

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

시작하기 전에

Xcode의 현재 버전을 설치합니다.

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

CocoaPods

CocoaPods가 아직 설치되어 있지 않으면 CocoaPods 시작 가이드의 단계를 따르세요.
터미널 창을 열고 앱의 Xcode 프로젝트 위치로 이동합니다.
애플리케이션의 Podfile을 아직 만들지 않았다면 지금 만듭니다.
```
pod init
```
애플리케이션용으로 만든 Podfile을 열고 다음을 추가합니다.
```
pod 'GoogleSignIn'
```
SwiftUI를 사용하는 경우 'Google 계정으로 로그인' 버튼의 포드 확장 프로그램도 추가합니다.
```
pod 'GoogleSignInSwiftSupport'
```
파일을 저장하고 다음 명령어를 실행합니다.
```
pod install
```
애플리케이션에서 생성된 .xcworkspace 작업공간 파일을 Xcode에서 엽니다. 향후 애플리케이션의 모든 개발 작업에 이 파일을 사용하세요. (포함된 .xcodeproj 프로젝트 파일과는 다릅니다. 이 파일을 열면 빌드 오류가 발생합니다.)

Objective-C 샘플 앱의 Podfile에서 예시를 참고하세요.

Swift Package Manager

Xcode에서 프로젝트를 엽니다.
앱에 Google 로그인 종속 항목을 추가합니다(Xcode 문서).

저장소 https://github.com/google/GoogleSignIn-iOS

버전 6.0.2

패키지 제품 GoogleSignIn
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를 만들려면 다음 안내를 따르세요.

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

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

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

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

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

반전된 클라이언트 ID는 클라이언트 ID로, 점으로 구분된 필드의 순서가 반대입니다. Cloud Console에서 기존 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 기기에서 기본적으로 실행되도록 Apple에서 발급한 인증서로 서명해야 합니다.

다음 단계

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

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