Настройте сервисы 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 , использующего библиотеку location:

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. Однако на устройствах без Google Play Store сервисы Google Play не установлены. Если ваше приложение работает на устройствах без сервисов Google Play, всегда проверяйте, установлены ли сервисы Google Play, прежде чем пытаться использовать API Google или включать функции, которые их требуют.

Для проверки наличия сервисов 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:24.8.0
Телефон, планшет
Идентификатор рекламной кампании Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.2.0
Телефон, планшет, Android TV, ChromeOS
Облегченная версия Google Mobile Ads
com.google.android.gms:play-services-ads-lite:24.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
AppSearch
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.4.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS
API для извлечения SMS
com.google.android.gms:play-services-auth-api-phone:18.3.0
Телефон, планшет, Android Go
API хранилища блоков (включает хранилище учетных данных пользователей)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Телефон, планшет, Android Go, ChromeOS
API Google Awareness
com.google.android.gms:play-services-awareness:19.1.0
Телефон, планшет, автомобиль, Android Go, ChromeOS
Классы полезности
com.google.android.gms:play-services-base:18.9.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Тестирование подделок на классы полезности
com.google.android.gms:play-services-base-testing:16.2.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Больше полезных классов
com.google.android.gms:play-services-basement:18.9.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Усиление камеры при слабом освещении
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta06
Телефон, планшет
Google Cast
com.google.android.gms:play-services-cast:22.2.0
Телефон, планшет, Android Go, ChromeOS
Платформа приложений Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.2.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.1
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Взаимодействие устройств (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Телефон, планшет, Android Go
Быстрая онлайн-аутентификация личности (FIDO)
com.google.android.gms:play-services-fido:21.2.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.3.0
Телефон, планшет, Android Go, ChromeOS, Wear OS
Google Play Games Services v2 для Android
com.google.android.gms:play-services-games-v2:21.0.0
Телефон, планшет, Android TV, Android Go, ChromeOS
Google Play Games Services v2 Нативный C SDK для Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Телефон, планшет, Android TV, Android Go, ChromeOS
Google Play Games Services v1 для Android
com.google.android.gms:play-services-games:24.0.0
Телефон, планшет, Android TV, Android Go, ChromeOS
API Matter
com.google.android.gms:play-services-home:16.0.0
Телефон, планшет
Google Play Мгновенный
com.google.android.gms:play-services-instantapps:18.2.0
Устарело. Подробнее см. в Google Play Instant .
Службы определения местоположения для Android
com.google.android.gms:play-services-location:21.3.0
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS
Google Maps SDK для Android
com.google.android.gms:play-services-maps:19.2.0
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS
Google Maps 3D SDK для Android
com.google.android.gms:play-services-maps3d:0.1.0
Телефон, планшет
сканирование штрихкода 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
Телефон, планшет, 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
Набор инструментов машинного обучения для распознавания текста на китайском языке.
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
Набор инструментов машинного обучения для распознавания текста на японском языке.
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Телефон, планшет, Android Go, ChromeOS
Набор инструментов машинного обучения для распознавания текста на корейском языке.
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.3.0
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS
Поддерживается на устройствах под управлением Android 5.0 (уровень API 21) или выше.
Библиотеки программного доступа (PAL)
com.google.android.gms:play-services-pal:23.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 Wallet (ранее 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 (включая безопасный просмотр и проверку приложений)
com.google.android.gms:play-services-safetynet:18.1.0
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS
Менеджер тегов Google
com.google.android.gms:play-services-tagmanager:18.3.0
Телефон, планшет, Android TV, Android Go, ChromeOS
API задач на Android
com.google.android.gms:play-services-tasks:18.4.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 GPU для сервисов Google Play
com.google.android.gms:play-services-tflite-gpu:16.4.0
Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite Java API для сервисов 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.3.0
Телефон, планшет
API доверенного времени
com.google.android.gms:play-services-time:16.0.1
Телефон, планшет, автомобиль, Android Go, Wear OS
Мобильное зрение
com.google.android.gms:play-services-vision:20.1.3
Телефон, планшет, Android Go, ChromeOS
Google Pay для платежей на Android
com.google.android.gms:play-services-wallet:19.5.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.9
Телефон, планшет, ChromeOS
Строгая проверка версий
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS