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

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

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

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

Объявить зависимости для сервисов 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.0.1'
}

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

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

Как описано в обзоре сервисов Google Play , сервисы Google Play получают автоматические обновления на Android 4.4 (уровень API 19) и выше через приложение Google Play Store. Однако на устройствах Android без Google Play Store службы Google Play не установлены. Если ваше приложение работает на устройствах без служб Google Play, вы можете проверить, установлены ли службы Google Play на устройстве, прежде чем пытаться использовать Google API, или включить функции в своем приложении, для работы которых требуются службы 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:22.1.0
Телефон, Планшет
Рекламный идентификатор Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
Телефон, планшет, Android TV, ChromeOS
Облегченная версия Google Mobile Ads
com.google.android.gms:play-services-ads-lite:22.1.0
Телефон, Планшет
AdSense для поиска (AFS) Объявления в пользовательском поиске (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
Телефон, планшет, Chrome OS
SDK сервисов Google Analytics для Android
com.google.android.gms:play-services-analytics:18.0.2
Устарело. Вместо этого используйте Google Analytics для Firebase .
Индекс приложения
com.google.android.gms:play-services-appindex:16.1.0
Телефон, Планшет, Андроид ТВ
Идентификатор набора приложений Android
com.google.android.gms:play-services-appset:16.0.2
Телефон, планшет, Android TV, ChromeOS
Вход в Google для Android
com.google.android.gms:play-services-auth:20.5.0
Телефон, планшет, Android TV, авто, Android Go, ChromeOS
API ретривера SMS
com.google.android.gms:play-services-auth-api-phone:18.0.1
Телефон, планшет, Android Go
API Block Store (включает хранилище учетных данных пользователя)
com.google.android.gms:play-services-auth-blockstore:16.2.0
Телефон, планшет, Android Go, ChromeOS
API осведомленности Google
com.google.android.gms:play-services-awareness:19.0.1
Телефон, планшет, авто, Android Go, ChromeOS
Вспомогательные классы
com.google.android.gms:play-services-base:18.2.0
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Тестирование подделок для служебных классов
com.google.android.gms:play-services-base-testing:16.0.0
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Дополнительные служебные классы
com.google.android.gms:play-services-basement:18.2.0
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.3.0
Телефон, планшет, Android Go, ChromeOS
Платформа приложений Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.3.0
Телефон, планшет, Android Go, ChromeOS
Сканер кода Google
com.google.android.gms:play-services-code-scanner:16.0.0
Телефон, планшет, Android Go, ChromeOS
Сетевой стек Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Взаимодействие между устройствами (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
Телефон, планшет, Android Go
Быстрая онлайн-аутентификация IDentity (FIDO)
com.google.android.gms:play-services-fido:20.0.1
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS

Поддерживается на устройствах под управлением Android 7.0 (уровень API 24) или выше.
API Google Fit для Android
com.google.android.gms:play-services-fitness:21.1.0
Телефон, планшет, Android Go, ChromeOS, Wear OS
Игровые сервисы Google Play v2 для Android
com.google.android.gms:play-services-games-v2:17.0.0
Телефон, планшет, 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.1.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.0.1
Телефон, планшет, Android TV, Android Go, ChromeOS

Поддерживается на устройствах под управлением Android 5.0 (уровень API 21) или выше.
Fused Location Provider для Android (включая распознавание активности и геозону)
com.google.android.gms:play-services-location:21.0.1
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
SDK Google Карт для Android
com.google.android.gms:play-services-maps:18.1.0
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Сканирование штрих-кода ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0
Телефон, планшет, Android Go, ChromeOS
ML Kit распознавание лиц
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Телефон, планшет, Android Go, ChromeOS
Маркировка изображений комплекта ML
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
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:19.0.0
Телефон, планшет, Android Go, ChromeOS
ML Kit для распознавания текста на китайском языке
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Телефон, планшет, Android Go, ChromeOS
Распознавание текста ML Kit для Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Телефон, планшет, Android Go, ChromeOS
ML Kit для распознавания текста на японском языке
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Телефон, планшет, Android Go, ChromeOS
ML Kit для распознавания текста на корейском языке
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
Телефон, планшет, Android Go, ChromeOS
Обнаружение устройств поблизости и подключение
com.google.android.gms:play-services-nearby:18.5.0
Телефон, планшет, Android TV, авто, Android Go
Показать лицензии с открытым исходным кодом
com.google.android.gms:play-services-oss-licenses:17.0.1
Телефон, планшет, Android TV, авто, 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 для пропусков
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
API-интерфейсы SafetyNet (включая аттестацию устройства, безопасный просмотр, reCAPTCHA и проверку приложений)
com.google.android.gms:play-services-safetynet:18.0.1
Телефон, планшет, Android TV, авто, Android Go, ChromeOS
Диспетчер тегов Google
com.google.android.gms:play-services-tagmanager:18.0.2
Телефон, планшет, Android TV, Android Go, ChromeOS
API задач на Android
com.google.android.gms:play-services-tasks:18.0.2
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Служба ускорения для Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API для сервисов Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite Java API для сервисов Google Play
com.google.android.gms:play-services-tflite-java:16.1.0
Телефон, планшет, Android Go, ChromeOS
API поддержки TensorFlow Lite для сервисов Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
Телефон, планшет, Android Go, ChromeOS
API сети потоков
com.google.android.gms:play-services-threadnetwork:16.0.0
Телефон, Планшет
Мобильное зрение
com.google.android.gms:play-services-vision:20.1.3
Телефон, планшет, Android Go, ChromeOS
Google Pay для платежей на Android
com.google.android.gms:play-services-wallet:19.2.0-beta01
Телефон, планшет, автомобиль, Android Go, ChromeOS, Wear OS
API уровня носимых данных
com.google.android.gms:play-services-wearable:18.0.0
Телефон, планшет, Wear OS

Плагины Gradle

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

Таблица 2. Список подключаемых модулей Gradle, включенных в сервисы Google Play
Пример использования и имя плагина Gradle Поддерживаемые устройства
Показать лицензии с открытым исходным кодом
com.google.android.gms:oss-licenses-plugin:0.10.6
Телефон, планшет, Chrome OS
Строгая проверка версий
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS