Geospatial API 및 Cloud Anchors와 같은 ARCore 기능은 Google Cloud에서 호스팅되는 ARCore API를 사용합니다. 이러한 기능을 사용하면 애플리케이션에서 사용자 인증 정보를 사용하여 ARCore API 서비스에 액세스합니다.
이 빠른 시작에서는 애플리케이션이 Google Cloud에서 호스팅되는 ARCore API 서비스와 통신할 수 있도록 설정하는 방법을 설명합니다.
새 Google Cloud 프로젝트 만들기 또는 기존 프로젝트 사용
기존 프로젝트가 있으면 해당 프로젝트를 선택합니다.
기존 Google Cloud 프로젝트가 없으면 프로젝트를 만듭니다.
ARCore API 사용 설정
ARCore API를 사용하려면 프로젝트에서 사용 설정해야 합니다.
승인 방법 설정
Android 애플리케이션은 키 없는 승인(OAuth 2.0)(권장됨)과 API 키 승인, 이렇게 두 가지 승인 방법을 사용하여 ARCore API와 통신할 수 있습니다.
- 키 없는 승인은 애플리케이션의 패키지 이름과 서명 키의 디지털 지문을 조합하여 애플리케이션을 승인합니다.
- API 키는 Google Cloud 프로젝트를 식별하는 문자열입니다. API 키는 일반적으로 클라이언트가 액세스할 수 있으므로 일반적으로 안전한 것으로 간주되지 않습니다. ARCore API와 통신할 때는 키 없는 승인을 사용하는 것이 좋습니다.
키 없음
키 없는 인증을 사용하여 앱을 승인하려면 OAuth 2.0 클라이언트 ID를 만듭니다.
서명 키 디지털 지문 확인
OAuth 2.0 클라이언트 ID는 앱의 서명 키 지문을 사용하여 앱을 식별합니다.
디버그 서명 지문을 가져오는 방법
프로젝트를 실행하거나 디버그할 때 Android SDK 도구는 생성된 디버그 인증서로 앱에 자동으로 서명합니다.
- Android 스튜디오에서 Gradle 도구 창을 엽니다.
- project-name > Tasks > Android로 이동합니다.
- signingReport 작업을 실행합니다.
- debug 변형의 SHA-1 디지털 지문을 복사합니다.
키 저장소에서 서명 지문을 가져오는 방법
키 저장소 파일이 있는 경우 keytool
유틸리티를 사용하여 지문을 확인합니다.
keytool -list -v -alias your-key-name -keystore path-to-production-keystore
그런 다음 keytool
유틸리티가 터미널에 지문을 출력합니다. 예를 들면 다음과 같습니다.
Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
Play 앱 서명에서 앱 서명 키를 가져오는 방법
Play 앱 서명을 사용하면 Google에서 앱의 서명 키를 관리하고 이 키를 사용하여 APK에 서명합니다. 이 키는 서명 지문에 사용해야 합니다.
- Google Play Console의 앱 서명 페이지에서 앱 서명 키 인증서로 스크롤합니다.
- SHA-1 인증서 지문을 사용합니다.
OAuth 2.0 클라이언트 ID 만들기
이전 단계의 적용 가능한 서명 키마다 Google Cloud 프로젝트의 사용자 인증 정보에서 OAuth 2.0 클라이언트 ID를 만듭니다.
Google Cloud에서 사용자 인증 정보 페이지를 엽니다.
사용자 인증 정보 만들기를 클릭한 후 메뉴에서 OAuth 클라이언트 ID를 선택합니다.
다음과 같이 필수 입력란을 작성합니다.
- 애플리케이션 유형: Android를 선택합니다.
- Package name: AndroidManifest.xml에 선언된 패키지 이름을 사용합니다.
- SHA-1 인증서 지문: 이전 단계에서 가져온 지문을 사용합니다.
만들기를 누릅니다.
필수 라이브러리 포함
- 앱의 종속 항목에
com.google.android.gms:play-services-auth:16+
를 포함합니다. 코드 압축을 사용하는 경우 앱의
build.gradle
파일에 추가합니다.buildTypes { release { ... proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } }
앱의
proguard-rules.pro
파일에 다음을 추가합니다.-keep class com.google.android.gms.common.** { *; } -keep class com.google.android.gms.location.** { *; } -keep class com.google.android.gms.auth.** { *; } -keep class com.google.android.gms.tasks.** { *; }
이제 앱이 키 없는 인증을 사용하도록 구성되었습니다.
API 키
- Google Cloud에서 사용자 인증 정보 페이지를 엽니다.
사용자 인증 정보 - 사용자 인증 정보 만들기를 클릭한 후 메뉴에서 API 키를 선택합니다.
API 키 생성 완료 대화상자에 새로 만든 키의 문자열이 표시됩니다. Android 스튜디오에서 프로젝트에 새 API 키를 추가합니다. 앱의
AndroidManifest.xml
에 있는<application>
요소의<meta-data>
요소에 API 키를 포함합니다.<meta-data android:name="com.google.android.ar.API_KEY" android:value="API_KEY"/>
- API 키를 보호하려면 API 키 제한사항에 대한 문서를 검토하세요.
이제 앱이 API 키를 사용하도록 구성되었습니다.
다음 단계
승인이 구성된 상태에서 이를 사용하는 다음 ARCore 기능을 확인합니다.