Настройте сервисы Google Play

Чтобы разработать приложение с использованием API сервисов Google Play , следуйте инструкциям на этой странице, чтобы настроить свой проект с помощью соответствующих SDK, которые доступны в репозитории Google maven .

Чтобы протестировать свое приложение при использовании сервисов Google Play, вам необходимо использовать одно из следующих действий:

  • Совместимое устройство Android под управлением Android 6.0 (уровень API 23) или более поздней версии, на котором установлено приложение Google Play Store.
  • Эмулятор Android с AVD , на котором работает платформа Google API на базе Android 6.0 (уровень API 23) или более поздней версии.

Объявить зависимости для сервисов Google Play

Чтобы разработать в вашем приложении функции, зависящие от API сервисов Google Play, выполните следующие действия:

  1. Откройте файл build.gradle в каталоге модулей вашего приложения.

  2. Для каждого SDK, который требуется вашему приложению, укажите зависимость для этого SDK. На этой странице есть раздел, в котором перечислены общие зависимости сервисов Google Play для приложений Android. Вы также можете добавить в свой проект зависимости Firebase .

  3. Сохраните изменения и синхронизируйте проект .

В следующем фрагменте показан пример файла build.gradle , использующего библиотеку местоположений:

apply plugin: 'com.android.application'

...

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

Периодически выпускаются новые версии SDK сервисов Google Play с исправлениями ошибок и новыми функциями. Эти обновления анонсируются в примечаниях к выпуску . Если ваше приложение использует обновленную зависимость, перейдите на последнюю версию зависимостей вашего приложения, чтобы воспользоваться этими исправлениями.

Проверьте, установлены ли сервисы Google Play

Как описано в обзоре сервисов Google Play , сервисы Google Play получают автоматические обновления для Android 6.0 (уровень API 23) и выше через приложение Google Play Store. Однако на устройствах Android без Google Play Store не установлены службы Google Play. Если ваше приложение работает на устройствах без служб Google Play, вы можете проверить, установлены ли службы Google Play на устройстве, прежде чем пытаться использовать API Google, или включить в своем приложении функции, для работы которых требуются службы Google Play.

Чтобы проверить наличие сервисов Google Play на устройстве, используйте метод isGooglePlayServicesAvailable() .

Чтобы затем начать подключение к сервисам Google Play или узнать, как определить, поддерживает ли установленная версия сервисов Google Play определенный API, прочтите руководство по доступу к API Google .

Зависимости сервисов Google Play

В следующей таблице перечислены зависимости для сервисов Google Play, которые вы можете включить в свое приложение Android. Вы можете отфильтровать список по типу устройства, выбрав одну из кнопок, а также выполнить поиск по конкретному варианту использования или имени зависимости, введя текст в поле, которое появляется после кнопок.

Таблица 1. Зависимости сервисов Google Play для включения в приложения Android
Вариант использования и имя зависимости Поддерживаемые устройства
Мобильная реклама Google
com.google.android.gms:play-services-ads:23.6.0
Телефон, Планшет
Рекламный идентификатор Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
Телефон, планшет, Android TV, ChromeOS
Облегченная версия Google Mobile Ads
com.google.android.gms:play-services-ads-lite:23.6.0
Телефон, Планшет
AdSense для поиска (AFS) Объявления в пользовательском поиске (CSA)
com.google.android.gms:play-services-afs-native:19.1.0
Телефон, планшет, ChromeOS
SDK служб Google Analytics для Android
com.google.android.gms:play-services-analytics:18.1.1
Устарело. Вместо этого используйте Google Analytics для Firebase .
Индекс приложений
com.google.android.gms:play-services-appindex:16.2.0
Телефон, планшет, Android TV
Поиск приложений
com.google.android.gms:play-services-appsearch:16.0.1
Телефон, планшет, Android TV
Идентификатор набора приложений для Android
com.google.android.gms:play-services-appset:16.1.0
Телефон, планшет, Android TV, ChromeOS
Вход в Google для Android
com.google.android.gms:play-services-auth:21.3.0
Телефон, планшет, Android TV, автомобиль, Android Go, ChromeOS
API SMS-ретривера
com.google.android.gms:play-services-auth-api-phone:18.1.0
Телефон, планшет, Android Go
API Block Store (включает хранилище учетных данных пользователя)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Телефон, планшет, Android Go, ChromeOS
API осведомленности Google
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, автомобиль, Android Go, ChromeOS, Wear OS
Тестирование подделок на предмет классов полезности
com.google.android.gms:play-services-base-testing:16.1.0
Телефон, планшет, Android TV, автомобиль, Android Go, ChromeOS, Wear OS
Больше полезных классов
com.google.android.gms:play-services-basement:18.5.0
Телефон, планшет, Android TV, автомобиль, Android Go, ChromeOS, Wear OS
Google Каст
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
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, автомобиль, Android Go, ChromeOS, Wear OS
Взаимодействие между устройствами (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Телефон, планшет, Android Go
Быстрая аутентификация IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.1.0
Телефон, планшет, Android TV, автомобиль, Android Go, ChromeOS, Wear OS

Поддерживается на устройствах под управлением Android 7.0 (уровень API 24) или выше.
API Google Fit для Android и API записи на мобильных устройствах (для данных о физической активности пользователя)
com.google.android.gms:play-services-fitness:21.2.0
Телефон, планшет, Android Go, ChromeOS, Wear OS
Игровые сервисы Google Play v2 для Android
com.google.android.gms:play-services-games-v2:20.1.2
Телефон, планшет, Android TV, Android Go, ChromeOS
Google Play Games Services v2 Native C SDK для Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Телефон, планшет, Android TV, Android Go, ChromeOS
Игровые сервисы Google Play v1 для Android
com.google.android.gms:play-services-games:23.2.0
Телефон, планшет, Android TV, Android Go, ChromeOS
Материя 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, автомобиль, Android Go, ChromeOS, Wear OS
SDK Google Карт для Android
com.google.android.gms:play-services-maps:19.0.0
Телефон, планшет, Android TV, автомобиль, 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, автомобиль, Android Go
Показать лицензии с открытым исходным кодом
com.google.android.gms:play-services-oss-licenses:17.1.0
Телефон, планшет, Android TV, автомобиль, 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
API SafetyNet (включает аттестацию устройств, безопасный просмотр, reCAPTCHA и проверку приложений)
com.google.android.gms:play-services-safetynet:18.1.0
Телефон, планшет, Android TV, автомобиль, Android Go, ChromeOS
Диспетчер тегов Google
com.google.android.gms:play-services-tagmanager:18.1.1
Телефон, планшет, Android TV, Android Go, ChromeOS
API задач на Android
com.google.android.gms:play-services-tasks:18.2.0
Телефон, планшет, Android TV, автомобиль, Android Go, ChromeOS, Wear OS
Служба ускорения для Android
com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01
Телефон, планшет, Android Go, ChromeOS
API делегата графического процессора TensorFlow Lite для сервисов Google Play
com.google.android.gms:play-services-tflite-gpu:16.4.0
Телефон, планшет, Android Go, ChromeOS
Java API TensorFlow Lite для сервисов Google Play
com.google.android.gms:play-services-tflite-java:16.4.0
Телефон, планшет, Android Go, ChromeOS
API поддержки TensorFlow Lite для сервисов Google Play
com.google.android.gms:play-services-tflite-support:16.4.0
Телефон, планшет, Android Go, ChromeOS
API сети потоков
com.google.android.gms:play-services-threadnetwork:16.2.1
Телефон, Планшет
Мобильное видение
com.google.android.gms:play-services-vision:20.1.3
Телефон, планшет, Android Go, ChromeOS
Google Pay для платежей на Android
com.google.android.gms:play-services-wallet:19.4.0
Телефон, планшет, автомобиль, Android Go, ChromeOS, Wear OS
API уровня данных носимых устройств
com.google.android.gms:play-services-wearable:19.0.0
Телефон, планшет, Wear OS

Плагины Gradle

Службы Google Play также включают в себя несколько плагинов Gradle, как показано в следующей таблице. Обратите внимание, что кнопки, расположенные перед предыдущей таблицей, не меняют информацию, отображаемую в этой таблице.

Таблица 2. Список плагинов Gradle, включенных в сервисы Google Play
Вариант использования и имя плагина 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, автомобиль, Android Go, ChromeOS, Wear OS