Important: Starting May 1, 2024, Apple requires Privacy Manifests and signatures for iOS applications that use commonly-used SDKs, including GoogleSignIn-iOS. Upgrade to GoogleSignIn-iOS v7.1.0+ before May 1, 2024. Follow our upgrade guide.

이 페이지는 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 project 파일과 다르다는 것을 확인합니다. 열릴 때 빌드 오류가 발생합니다.)

Objective-C 샘플 앱의 Podfile 예로 들겠습니다.

Swift Package Manager

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

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

버전 7.0.0

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

패키지 제품 GoogleSignInSwift

OAuth 클라이언트 ID 가져오기

Google의 인증에서 앱을 식별하려면 OAuth 클라이언트 ID가 필요합니다. 사용할 수 있습니다 iOS 및 macOS 앱의 경우 OAuth 클라이언트 ID 애플리케이션 유형 iOS로 구성해야 합니다.

아직 OAuth 클라이언트 ID를 생성하지 않았다면 버튼을 클릭합니다. 방법은 다음과 같습니다.

OAuth 클라이언트 ID 만들기

OAuth 클라이언트 ID를 만든 후 클라이언트 ID 문자열을 기록해 둡니다. 앱에서 Google 로그인을 구성해야 합니다. 원하는 경우 클라이언트 ID 및 기타 클라이언트 ID가 포함된 구성 파일을 나중에 참조할 수 있습니다.

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

<ph type="x-smartling-placeholder"></ph> 기존 OAuth 클라이언트 ID 가져오기

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

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

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

다음에서 프로젝트를 엽니다. Cloud 콘솔.
새로운 웹 애플리케이션 유형의 OAuth 클라이언트 ID를 만듭니다. 다음 클라이언트 ID 문자열로, 구성 영역에서 Google 로그인을 구성하는 데 있습니다.

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

Google 로그인을 사용하려면 프로젝트를 OAuth 클라이언트 ID로 구성해야 합니다. 커스텀 URL 스키마가 포함됩니다 필요한 경우 서버 클라이언트 ID를 추가하여 백엔드 인증 또는 Google Workspace 도메인입니다.

OAuth 클라이언트 ID 및 커스텀 URL 스킴 추가

앱의 Info.plist 파일을 업데이트하여 OAuth를 추가합니다. 클라이언트 ID 및 역방향 클라이언트 ID에 기반한 커스텀 URL 스키마

반전된 클라이언트 ID는 점으로 구분된 순서의 클라이언트 ID입니다. 필드가 반전되었습니다. 'iOS URL 스키마'에도 표시됩니다. 태그를 선택할 때 클라우드의 기존 iOS OAuth 클라이언트 콘솔을 참고하세요. 예: 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 영역에 맞게 최적화

다음과 같은 서비스의 로그인 과정을 최적화하려면 GIDHostedDomain 매개변수를 사용하세요. Google Workspace 도메인

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

OpenID 영역을 지정하려면 GIDOpenIDRealm 매개변수를 사용합니다.

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

애플리케이션 서명

애플리케이션을 실행하려면 Apple에서 발급한 인증서로 서명해야 합니다. 기본적으로 macOS 및 iOS 기기에서 사용할 수 있습니다.

다음 단계

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

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