Google Play 서비스 설정

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에 종속되는 기능을 개발하려면 다음 단계를 완료하세요.

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

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

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

다음 스니펫은 위치 라이브러리를 사용하는 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 서비스의 종속 항목이 나와 있습니다. 버튼 중 하나를 선택하여 기기 유형별로 목록을 필터링할 수 있으며, 버튼 뒤에 표시되는 상자에 텍스트를 입력하여 특정 사용 사례 또는 종속 항목 이름을 검색할 수 있습니다.

표 1. 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 애널리틱스 서비스 SDK
com.google.android.gms:play-services-analytics:18.1.1
지원 중단되었습니다. 대신 Firebase용 Google 애널리틱스를 사용하세요.
앱 색인
com.google.android.gms:play-services-appindex:16.2.0
휴대전화, 태블릿, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
휴대전화, 태블릿, Android TV
Android 앱 세트 ID
com.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 API
com.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 API
com.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.4.0
휴대전화, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.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 Scanner
com.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 게임즈 서비스 v2
com.google.android.gms:play-services-games-v2:20.1.2
휴대전화, 태블릿, 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.2.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.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 SDK
com.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 Enterprise
com.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 API
com.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 API
com.google.android.gms:play-services-tflite-gpu:16.3.0
휴대전화, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.3.0
휴대전화, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite 지원 API
com.google.android.gms:play-services-tflite-support:16.3.0
휴대전화, 태블릿, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
휴대전화, 태블릿
모바일 비전
com.google.android.gms:play-services-vision:20.1.3
휴대전화, 태블릿, Android Go, ChromeOS
Android에서 결제할 때 사용하는 Google Pay
com.google.android.gms:play-services-wallet:19.4.0
휴대전화, 태블릿, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.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