Настройка служб Google Play

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

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

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

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

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

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

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

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

Ниже приведен пример файла build.gradle, в котором используется библиотека местоположений.

apply plugin: 'com.android.application'

...

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

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

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

Как описано в обзоре сервисов Google Play, они автоматически обновляются на устройствах с Android 7.0 (уровень API 24) и более поздними версиями через приложение Google Play. Однако на устройствах без 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 Mobile Ads
com.google.android.gms:play-services-ads:25.5.0
Телефон, планшет
Рекламный идентификатор Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.3.0
Телефон, планшет, Android TV, ChromeOS
Облегченная версия Google Mobile Ads
com.google.android.gms:play-services-ads-lite:25.0.0
Телефон, планшет
Реклама в пользовательском поиске AdSense для поиска
com.google.android.gms:play-services-afs-native:19.1.0
Телефон, планшет, ChromeOS
Google Analytics Services SDK для Android
com.google.android.gms:play-services-analytics:18.1.1
Поддержка прекращена. Вместо этого используйте Google Аналитику для 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:22.0.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.3.1
Телефон, планшет, Android Go
Block Store API (включает хранилище учетных данных пользователей)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Телефон, планшет, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:20.0.0
Телефон, планшет, Android Auto, Android Go, ChromeOS
Вспомогательные классы
com.google.android.gms:play-services-base:18.11.1
Телефон, планшет, 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.12.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Усиление при слабом освещении
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09
Телефон, планшет
Google Cast
com.google.android.gms:play-services-cast:22.3.1
Телефон, планшет, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:22.3.1
Телефон, планшет, Android Go, ChromeOS
Google Code Scanner
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
Взаимодействие между устройствами
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Телефон, планшет, Android Go
Key Verifier SDK
com.google.android.gms:contactkeys:16.0.0
Телефон, планшет
Аутентификация Fast IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.3.0
Телефоны, планшеты, Android TV, Android Auto, Android Go, ChromeOS, Wear OS.

Поддерживается на устройствах с Android 7.0 (уровень API 24) и более поздними версиями.
Google Fit API для Android и Recording API на мобильных устройствах (для данных о физической активности пользователей).
com.google.android.gms:play-services-fitness:21.3.0
Телефон, планшет, Android Go, ChromeOS, Wear OS
Защита от мошенничества
com.google.android.gms:play-services-fraudprotect:16.0.1
Телефон, планшет, Android Go
Сервисы Google Play Games версии 2 для Android
com.google.android.gms:play-services-games-v2:22.1.0
Телефон, планшет, Android TV, Android Go, ChromeOS
Сервисы Google Play Games 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 Games версии 1 для Android
com.google.android.gms:play-services-games:25.0.0
Поддержка прекращена. Используйте сервисы Google Play Games версии 2.
Matter API
com.google.android.gms:play-services-home:16.0.0
Телефон, планшет
Google Play Instant
com.google.android.gms:play-services-instantapps:18.2.0
Поддержка прекращена. Подробнее о Google Play Instant…
Сервисы геолокации для Android
com.google.android.gms:play-services-location:21.4.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Maps SDK для Android
com.google.android.gms:play-services-maps:20.1.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Карты 3D SDK для Android
com.google.android.gms:play-services-maps3d:16.0.1
Телефон, планшет
Улучшение медиаэффектов
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta09
Телефон, планшет
Студийный звук
com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02
Телефон, планшет
Сканирование штрихкодов с помощью 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 image labeling custom
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.5.1
Телефон, планшет, Android TV, Auto, Android Go
Показать лицензии открытого ПО
com.google.android.gms:play-services-oss-licenses:17.5.2
Телефоны, планшеты, Android TV, Android Auto, 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 Кошелек (ранее – Google Pay для карт и билетов)
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
Remote Gestures API
com.google.android.gms:play-services-remotegestures:16.0.0
Телефон, планшет
Safe Browsing v5
com.google.android.gms:play-services-safebrowsing:16.0.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS
SafetyNet API (включая Безопасный просмотр и проверку приложений)
com.google.android.gms:play-services-safetynet:18.1.0
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS
Google Менеджер тегов
com.google.android.gms:play-services-tagmanager:18.3.0
Телефон, планшет, Android TV, Android Go, ChromeOS
Tasks API для Android
com.google.android.gms:play-services-tasks:18.4.1
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service for Android
com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02
Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API для сервисов Google Play
com.google.android.gms:play-services-tflite-gpu:16.5.0
Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite Java API для сервисов Google Play
com.google.android.gms:play-services-tflite-java:16.5.0
Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite Support API для сервисов Google Play
com.google.android.gms:play-services-tflite-support:16.5.0
Телефон, планшет, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.3.0
Телефон, планшет
Trusted Time API
com.google.android.gms:play-services-time:16.0.1
Телефон, планшет, Android Auto, Android Go, Wear OS
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Телефон, планшет, Android Go, ChromeOS
Google Pay для платежей на Android
com.google.android.gms:play-services-wallet:20.0.0
Телефон, планшет, Android Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:20.0.1
Телефон, планшет, Wear OS

Плагины Gradle

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

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