Google Play 서비스 API를 사용하여 앱을 개발하려면 이 페이지의 안내에 따라 Google Maven 저장소에서 제공되는 관련 SDK로 프로젝트를 설정하세요.
Google Play 서비스를 사용할 때 앱을 테스트하려면 다음 중 하나를 사용해야 합니다.
- Android 6.0 (API 수준 23) 이상을 실행하고 Google Play 스토어 앱이 설치된 호환 Android 기기
- Android 6.0 (API 수준 23) 이상 기반의 Google API 플랫폼을 실행하는 AVD가 포함된 Android 에뮬레이터
Google Play 서비스 종속 항목 선언
앱에서 Google Play 서비스 API에 종속되는 기능을 개발하려면 다음 단계를 완료하세요.
앱의 모듈 디렉터리 내에 있는
build.gradle파일을 엽니다.앱에 필요한 각 SDK의 종속 항목을 포함합니다. 이 페이지에는 Android 앱의 일반적인 Google Play 서비스 종속 항목이 나열된 섹션이 포함되어 있습니다. 프로젝트에 Firebase 종속 항목을 추가하는 것도 좋습니다.
변경사항을 저장하고 프로젝트를 동기화합니다.
다음 스니펫은 위치 라이브러리를 사용하는 build.gradle 파일의 예를 보여줍니다.
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
버그 수정 및 새로운 기능이 포함된 Google Play 서비스 SDK의 새 버전이 주기적으로 출시됩니다. 이러한 업데이트는 출시 노트에 발표됩니다. 앱이 업데이트된 종속 항목을 사용하는 경우 앱의 종속 항목에서 최신 버전으로 변경하여 이러한 수정사항을 활용하세요.
Google Play 서비스가 설치되어 있는지 확인
Google Play 서비스 개요에 설명된 대로 Google Play 서비스는 Android 6.0 (API 수준 23) 이상에서 Google Play 스토어 앱을 통해 자동 업데이트를 수신합니다. 하지만 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 서비스의 종속 항목이 나와 있습니다. 버튼 중 하나를 선택하여 기기 유형별로 목록을 필터링할 수 있으며, 버튼 뒤에 표시되는 상자에 텍스트를 입력하여 특정 사용 사례 또는 종속 항목 이름을 검색할 수 있습니다.
| 사용 사례 및 종속 항목 이름 | 지원되는 기기 |
|---|---|
Google 모바일 광고com.google.android.gms:play-services-ads:23.5.0 |
휴대전화, 태블릿 |
Android Advertising ID (AAID)com.google.android.gms:play-services-ads-identifier:18.1.0 |
휴대전화, 태블릿, Android TV, ChromeOS |
가벼운 버전의 Google 모바일 광고com.google.android.gms:play-services-ads-lite:23.5.0 |
휴대전화, 태블릿 |
검색용 애드센스 (AFS) 맞춤검색 광고 (CSA)com.google.android.gms:play-services-afs-native:19.1.0 |
휴대전화, 태블릿, ChromeOS |
Android용 Google 애널리틱스 서비스 SDKcom.google.android.gms:play-services-analytics:18.1.1 |
지원 중단되었습니다. 대신 Firebase용 Google 애널리틱스를 사용하세요. |
앱 색인com.google.android.gms:play-services-appindex:16.2.0 |
휴대전화, 태블릿, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
휴대전화, 태블릿, Android TV |
Android 앱 세트 IDcom.google.android.gms:play-services-appset:16.1.0 |
휴대전화, 태블릿, Android TV, ChromeOS |
Android용 Google 로그인com.google.android.gms:play-services-auth:21.2.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.1.0 |
휴대전화, 태블릿, Android Go |
Block Store API (사용자 사용자 인증 정보 저장소 포함)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.1.0 |
휴대전화, 태블릿, 자동차, Android Go, ChromeOS |
유틸리티 클래스com.google.android.gms:play-services-base:18.5.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
유틸리티 클래스의 가짜 테스트com.google.android.gms:play-services-base-testing:16.1.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
유틸리티 클래스 더보기com.google.android.gms:play-services-basement:18.5.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:22.0.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Google Cast 애플리케이션 프레임워크 (CAF)com.google.android.gms:play-services-cast-framework:22.0.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Google Code Scannercom.google.android.gms:play-services-code-scanner:16.1.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Chromium 네트워크 스택 (Cronet)com.google.android.gms:play-services-cronet:18.1.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
기기 간 상호작용 (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
휴대전화, 태블릿, Android Go |
Fast IDentity Online (FIDO) 인증com.google.android.gms:play-services-fido:21.1.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS Android 7.0 (API 수준 24) 이상을 실행하는 기기에서 지원됩니다. |
Android용 Google Fit API 및 모바일의 녹음 API (사용자 피트니스 데이터용)com.google.android.gms:play-services-fitness:21.2.0 |
휴대전화, 태블릿, Android Go, ChromeOS, Wear OS |
Android용 Google Play 게임즈 서비스 v2com.google.android.gms:play-services-games-v2:20.1.2 |
휴대전화, 태블릿, Android TV, Android Go, ChromeOS |
Android용 Google Play 게임즈 서비스 v2 네이티브 C SDKcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
휴대전화, 태블릿, Android TV, Android Go, ChromeOS |
Android용 Google Play 게임즈 서비스 v1com.google.android.gms:play-services-games:23.2.0 |
휴대전화, 태블릿, Android TV, Android Go, ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
휴대전화, 태블릿 |
Google Play 인스턴트com.google.android.gms:play-services-instantapps:18.1.0 |
휴대전화, 태블릿, Android TV, Android Go, ChromeOS Android 5.0 (API 수준 21) 이상을 실행하는 기기에서 지원됩니다. |
Android용 위치 서비스com.google.android.gms:play-services-location:21.3.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Android용 Google Maps SDKcom.google.android.gms:play-services-maps:19.0.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
ML Kit 바코드 스캔com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
휴대전화, 태블릿, 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.1 |
휴대전화, 태블릿, Android Go, ChromeOS |
중국어용 ML Kit 텍스트 인식com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
휴대전화, 태블릿, Android Go, ChromeOS |
데바나그리어용 ML Kit 텍스트 인식com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
휴대전화, 태블릿, Android Go, ChromeOS |
일본어용 ML Kit 텍스트 인식com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
휴대전화, 태블릿, Android Go, ChromeOS |
한국어용 ML Kit 텍스트 인식com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 |
휴대전화, 태블릿, Android Go, ChromeOS |
근처 기기 검색 및 연결com.google.android.gms:play-services-nearby:19.3.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go |
오픈소스 라이선스 표시com.google.android.gms:play-services-oss-licenses:17.1.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS Android 5.0 (API 수준 21) 이상을 실행하는 기기에서 지원됩니다. |
프로그래매틱 액세스 라이브러리 (PAL)com.google.android.gms:play-services-pal:21.0.0 |
휴대전화, 태블릿, Android TV Android 5.0 (API 수준 21) 이상을 실행하는 기기에서 지원됩니다. |
화면 잠금 품질 검사 com.google.android.gms:play-services-password-complexity:18.1.0 |
휴대전화, 태블릿, Android Go, ChromeOS, Wear OS Android 4.4 (API 수준 19)~Android 9 (API 수준 28)을 실행하는 기기에서 지원됩니다. |
Google 월렛 (이전 명칭: Google Pay for Passes)com.google.android.gms:play-services-pay:16.5.0 |
휴대전화, 태블릿, Android Go, ChromeOS Android 5.0 (API 수준 20) 이상을 실행하는 기기에서 지원됩니다. |
앱 계측을 위한 reCAPTCHA Enterprisecom.google.android.gms:play-services-recaptcha:17.1.0 |
휴대전화, 태블릿, Android TV, Android Go, ChromeOS |
SafetyNet API (기기 증명, 세이프 브라우징, reCAPTCHA, 앱 인증 포함)com.google.android.gms:play-services-safetynet:18.1.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS |
Google 태그 관리자com.google.android.gms:play-services-tagmanager:18.1.1 |
휴대전화, 태블릿, Android TV, Android Go, ChromeOS |
Android의 Tasks APIcom.google.android.gms:play-services-tasks:18.2.0 |
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Android용 가속 서비스com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01 |
휴대전화, 태블릿, Android Go, ChromeOS |
Google Play 서비스용 TensorFlow Lite GPU Delegate APIcom.google.android.gms:play-services-tflite-gpu:16.3.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Google Play 서비스용 TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.3.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Google Play 서비스용 TensorFlow Lite 지원 APIcom.google.android.gms:play-services-tflite-support:16.3.0 |
휴대전화, 태블릿, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.2.1 |
휴대전화, 태블릿 |
모바일 비전com.google.android.gms:play-services-vision:20.1.3 |
휴대전화, 태블릿, Android Go, ChromeOS |
Android에서 결제할 때 사용하는 Google Paycom.google.android.gms:play-services-wallet:19.4.0 |
휴대전화, 태블릿, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.0 |
휴대전화, 태블릿, Wear OS |
Gradle 플러그인
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 |