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

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

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

  • Совместимое устройство Android под управлением Android 6.0 (уровень API 23) или выше, на котором установлено приложение Google Play Store.
  • Эмулятор Android с AVD , работающий на платформе API Google на базе 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, перед использованием 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:24.4.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.3.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.3.0
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS
API для извлечения SMS
com.google.android.gms:play-services-auth-api-phone:18.2.0
Телефон, планшет, Android Go
API Block Store (включает хранилище учетных данных пользователя)
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.7.2
Телефон, планшет, 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.7.1
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS
Улучшение камеры при слабом освещении
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta03
Телефон, планшет
Google Cast
com.google.android.gms:play-services-cast:22.1.0
Телефон, планшет, Android Go, ChromeOS
Платформа приложений Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.1.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
Аутентификация Fast IDentity Online (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.2.0
Телефон, планшет, Android Go, ChromeOS, Wear OS
Игровые сервисы Google Play v2 для Android
com.google.android.gms:play-services-games-v2:21.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.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.2.0
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS
Google Maps 3D SDK для Android
com.google.android.gms:play-services-maps3d:0.0.2
Телефон, планшет
Сканирование штрихкода комплектом ML
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.2.1
Телефон, планшет, Android TV, Авто, Android Go, ChromeOS
Поддерживается на устройствах под управлением Android 5.0 (уровень API 21) или выше.
Библиотеки программного доступа (PAL)
com.google.android.gms:play-services-pal:22.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.3.2
Телефон, планшет, 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.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