Google Play 서비스 설정

Google Play 서비스 API를 사용하여 앱을 개발하려면 이 페이지의 안내에 따라 Google Maven 저장소에서 제공되는 관련 SDK로 프로젝트를 설정하세요.

Google Play 서비스를 사용할 때 앱을 테스트하려면 다음 중 하나를 사용해야 합니다.

  • Android 5.0 (API 수준 21) 이상을 실행하고 Google Play 스토어 앱이 설치된 호환 Android 기기
  • Android 5.0 (API 수준 21) 이상 기반의 Google API 플랫폼을 실행하는 AVD가 포함된 Android Emulator

Google Play 서비스 종속 항목 선언

앱에서 Google Play 서비스 API를 사용하는 기능을 개발하려면 다음 단계를 완료하세요.

  1. 앱의 모듈 디렉터리 내에 있는 build.gradle 파일을 엽니다.

  2. 앱에 필요한 각 SDK에 대해 해당 SDK의 종속 항목을 포함합니다. 이 페이지에는 Android 앱의 일반적인 Google Play 서비스 종속 항목을 나열하는 섹션이 포함되어 있습니다. 또한 프로젝트에 Firebase 종속 항목을 추가하는 것이 좋습니다.

  3. 변경사항을 저장하고 프로젝트를 동기화합니다.

다음 스니펫은 위치 라이브러리를 사용하는 build.gradle 파일의 예를 보여줍니다.

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.2.0'
}

버그가 수정되고 새로운 기능이 포함된 Google Play 서비스 SDK의 새 버전이 정기적으로 출시됩니다. 이 업데이트는 출시 노트에 발표됩니다. 앱이 업데이트된 종속 항목을 사용하는 경우 이러한 수정사항을 활용할 수 있도록 앱 종속 항목의 최신 버전으로 변경합니다.

Google Play 서비스가 설치되어 있는지 확인

Google Play 서비스 개요에 설명된 대로 Google Play 서비스는 Google Play 스토어 앱을 통해 Android 5.0 (API 수준 21) 이상에서 자동 업데이트를 받습니다. 그러나 Google Play 스토어가 없는 Android 기기에는 Google Play 서비스가 설치되어 있지 않습니다. 앱이 Google Play 서비스가 없는 기기에서 실행되는 경우 Google API를 사용하기 전에 기기에 Google Play 서비스가 설치되어 있는지 확인하거나 Google Play 서비스가 작동해야 하는 기능을 앱에서 사용 설정하는 것이 좋습니다.

기기에 Google Play 서비스가 있는지 확인하려면 isGooglePlayServicesAvailable() 메서드를 사용합니다.

그런 다음 Google Play 서비스 연결을 시작하거나 설치된 Google Play 서비스 버전이 특정 API를 지원하는지 확인하는 방법을 알아보려면 Google API 액세스에 관한 가이드를 읽어보세요.

Google Play 서비스 종속 항목

다음 표에는 Android 앱에 포함할 수 있는 Google Play 서비스의 종속 항목이 나열되어 있습니다. 버튼 중 하나를 선택하여 기기 유형별로 목록을 필터링할 수 있으며, 버튼 다음에 표시되는 상자에 텍스트를 입력하여 특정 사용 사례나 종속 항목 이름을 검색할 수 있습니다.

표 1. Android 앱에 포함할 Google Play 서비스 종속 항목
사용 사례 및 종속 항목 이름 지원되는 기기
Google 모바일 광고
com.google.android.gms:play-services-ads:22.6.0
스마트폰, 태블릿
Android 광고 ID (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
휴대전화, 태블릿, Android TV, ChromeOS
Google 모바일 광고의 경량 버전
com.google.android.gms:play-services-ads-lite:22.6.0
스마트폰, 태블릿
검색용 애드센스 (AFS) 맞춤 검색 광고 (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
휴대전화, 태블릿, ChromeOS
Android용 Google 애널리틱스 서비스 SDK
com.google.android.gms:play-services-analytics:18.0.4
지원 중단되었습니다. 대신 Firebase용 Google 애널리틱스를 사용하세요.
앱 색인
com.google.android.gms:play-services-appindex:16.1.0
휴대전화, 태블릿, Android TV
Android 앱 세트 ID
com.google.android.gms:play-services-appset:16.0.2
휴대전화, 태블릿, Android TV, ChromeOS
Android용 Google 로그인
com.google.android.gms:play-services-auth:21.0.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.0.2
휴대전화, 태블릿, Android Go
Block Store API (사용자 인증 정보 저장소 포함)
com.google.android.gms:play-services-auth-blockstore:16.2.0
휴대전화, 태블릿, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
휴대전화, 태블릿, Auto, Android Go, ChromeOS
유틸리티 클래스
com.google.android.gms:play-services-base:18.3.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
유틸리티 클래스의 가짜 테스트
com.google.android.gms:play-services-base-testing:16.0.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
유틸리티 클래스 더보기
com.google.android.gms:play-services-basement:18.3.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.4.0
휴대전화, 태블릿, Android Go, ChromeOS
Google Cast 애플리케이션 프레임워크 (CAF)
com.google.android.gms:play-services-cast-framework:21.4.0
휴대전화, 태블릿, Android Go, ChromeOS
Android TV 수신기
com.google.android.gms:play-services-cast-tv:21.0.1
Android TV
Google 코드 스캐너
com.google.android.gms:play-services-code-scanner:16.1.0
휴대전화, 태블릿, Android Go, ChromeOS
Chromium 네트워크 스택 (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
기기 간 상호작용 (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
휴대전화, 태블릿, Android Go
Fast IDentity Online (FIDO) 인증
com.google.android.gms:play-services-fido:20.1.0
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS

Android 7.0 (API 수준 24) 이상을 실행하는 기기에서 지원됩니다.
Android용 Google 피트니스 API
com.google.android.gms:play-services-fitness:21.1.0
휴대전화, 태블릿, Android Go, ChromeOS, Wear OS
Android용 Google Play 게임즈 서비스 v2
com.google.android.gms:play-services-games-v2:19.0.0
휴대전화, 태블릿, Android TV, Android Go, ChromeOS
Android용 Google Play 게임즈 서비스 v2 네이티브 C SDK
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
휴대전화, 태블릿, Android TV, Android Go, ChromeOS
Android용 Google Play 게임즈 서비스 v1
com.google.android.gms:play-services-games:23.1.0
휴대전화, 태블릿, Android TV, Android Go, ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
스마트폰, 태블릿
Google Play 인스턴트
com.google.android.gms:play-services-instantapps:18.0.1
스마트폰, 태블릿, Android TV, Android Go, ChromeOS

Android 5.0 (API 수준 21) 이상을 실행하는 기기에서 지원됩니다.
Android용 위치 서비스
com.google.android.gms:play-services-location:21.2.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Android용 Google Maps SDK
com.google.android.gms:play-services-maps:18.2.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
ML Kit 바코드 스캔
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 문서 스캐너
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 얼굴 인식
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 이미지 라벨 지정
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 이미지 라벨 지정 커스텀
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 언어 식별
com.google.android.gms:play-services-mlkit-language-id:17.0.0
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 스마트 답장
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 주제 세분화
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
휴대전화, 태블릿, Android Go, ChromeOS
ML Kit 텍스트 인식
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
휴대전화, 태블릿, Android Go, ChromeOS
중국어 ML Kit 텍스트 인식
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
휴대전화, 태블릿, Android Go, ChromeOS
Devanagari용 ML Kit 텍스트 인식
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
휴대전화, 태블릿, Android Go, ChromeOS
일본어 ML Kit 텍스트 인식
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
휴대전화, 태블릿, Android Go, ChromeOS
한국어용 ML Kit 텍스트 인식
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
휴대전화, 태블릿, Android Go, ChromeOS
근처 기기 검색 및 연결
com.google.android.gms:play-services-nearby:19.1.0
휴대전화, 태블릿, Android TV, Auto, Android Go
오픈소스 라이선스 표시
com.google.android.gms:play-services-oss-licenses:17.0.1
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS
Android 5.0 (API 수준 21) 이상을 실행하는 기기에서 지원됩니다.
화면 잠금 품질 검사
com.google.android.gms:play-services-password-complexity:18.0.1
스마트폰, 태블릿, Android Go, ChromeOS, Wear OS

Android 4.4 (API 수준 19)~Android 9 (API 수준 28)를 실행하는 기기에서 지원됩니다.
Google 월렛 (이전 명칭: Google Pay for Pass)
com.google.android.gms:play-services-pay:16.4.0
스마트폰, 태블릿, Android Go, ChromeOS

Android 5.0 (API 수준 20) 이상을 실행하는 기기에서 지원됩니다.
앱 계측을 위한 reCAPTCHA Enterprise
com.google.android.gms:play-services-recaptcha:17.0.1
휴대전화, 태블릿, Android TV, Android Go, ChromeOS
SafetyNet API (기기 증명, 세이프 브라우징, reCAPTCHA, 앱 인증 포함)
com.google.android.gms:play-services-safetynet:18.0.1
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS
Google 태그 관리자
com.google.android.gms:play-services-tagmanager:18.0.4
휴대전화, 태블릿, Android TV, Android Go, ChromeOS
Android의 Tasks API
com.google.android.gms:play-services-tasks:18.1.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Android용 가속 서비스
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
휴대전화, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite GPU Delegate API
com.google.android.gms:play-services-tflite-gpu:16.2.0
휴대전화, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
휴대전화, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite Support API
com.google.android.gms:play-services-tflite-support:16.1.0
휴대전화, 태블릿, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0
스마트폰, 태블릿
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
휴대전화, 태블릿, Android Go, ChromeOS
Android의 Google Pay for Payments
com.google.android.gms:play-services-wallet:19.3.0
휴대전화, 태블릿, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.1.0
스마트폰, 태블릿, Wear OS

Gradle 플러그인

Google Play 서비스에는 다음 표와 같이 몇 가지 Gradle 플러그인도 포함되어 있습니다. 이전 표 앞에 표시되는 버튼을 사용해도 이 표에 표시되는 정보는 변경되지 않습니다.

표 2. Google Play 서비스에 포함된 Gradle 플러그인 목록
사용 사례 및 Gradle 플러그인 이름 지원되는 기기
오픈소스 라이선스 표시
com.google.android.gms:oss-licenses-plugin:0.10.6
휴대전화, 태블릿, ChromeOS
엄격한 버전 확인
com.google.android.gms:strict-version-matcher-plugin:1.2.4
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS