Google Play 서비스 설정

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

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

  • Android 4.4 (API 수준 19) 이상을 실행하고 Google Play 스토어 앱이 설치된 호환 Android 기기
  • Android 4.4 (API 수준 19) 이상을 기반으로 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.0.1'
}

버그 수정 및 새로운 기능이 포함된 Google Play 서비스 SDK의 새 버전이 주기적으로 출시됩니다. 이러한 업데이트는 출시 노트에 발표됩니다. 앱이 업데이트된 종속 항목을 사용하는 경우 이러한 수정사항을 활용하려면 최신 버전의 종속 항목으로 변경하세요.

Google Play 서비스가 설치되었는지 확인하기

Google Play 서비스 개요에 설명된 대로 Google Play 서비스는 Android 4.4 (API 수준 19) 이상에서 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:21.5.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:21.5.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.2
지원 중단되었습니다. 대신 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:20.4.1
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.0.1
스마트폰, 태블릿, Android Go
Block Store API (사용자 인증 정보 스토리지 포함)
com.google.android.gms:play-services-auth-blockstore:16.1.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.1.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.1.0
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.2.0
스마트폰, 태블릿, Android Go, ChromeOS
Google Cast 애플리케이션 프레임워크 (CAF)
com.google.android.gms:play-services-cast-framework:21.2.0
스마트폰, 태블릿, Android Go, ChromeOS
Android TV 수신기
com.google.android.gms:play-services-cast-tv:20.0.0
Android TV
Google 코드 스캐너
com.google.android.gms:play-services-code-scanner:16.0.0-beta3
스마트폰, 태블릿, 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
빠른 ID 항목 온라인 (FIDO) 인증
com.google.android.gms:play-services-fido:19.0.1
스마트폰, 태블릿, 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:17.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.0.1
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Android용 Google Maps SDK
com.google.android.gms:play-services-maps:18.1.0
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
ML Kit 바코드 스캔
com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0
스마트폰, 태블릿, 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-beta4
스마트폰, 태블릿, 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-text-recognition:18.0.2
스마트폰, 태블릿, Android Go, ChromeOS
근처 기기 검색 및 연결
com.google.android.gms:play-services-nearby:18.3.0
스마트폰, 태블릿, Android TV, Auto, Android Go
오픈소스 라이선스 표시
com.google.android.gms:play-services-oss-licenses:17.0.0
스마트폰, 태블릿, 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 Pay for Passes
com.google.android.gms:play-services-pay:16.1.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.2
스마트폰, 태블릿, Android TV, Android Go, ChromeOS
Android의 Tasks API
com.google.android.gms:play-services-tasks:18.0.2
스마트폰, 태블릿, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Play 서비스용 TensorFlow Lite GPU Delegate API
com.google.android.gms:play-services-tflite-gpu:16.1.0
스마트폰, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite 자바 API
com.google.android.gms:play-services-tflite-java:16.0.1
스마트폰, 태블릿, Android Go, ChromeOS
Google Play 서비스용 TensorFlow Lite Support API
com.google.android.gms:play-services-tflite-support:16.0.1
스마트폰, 태블릿, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0-beta02
스마트폰, 태블릿
모바일 비전
com.google.android.gms:play-services-vision:20.1.3
스마트폰, 태블릿, Android Go, ChromeOS
Android에서 Google Pay로 결제 시
com.google.android.gms:play-services-wallet:19.1.0
스마트폰, 태블릿, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.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