Настройка служб 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 не установлены. Если ваше приложение работает на устройствах без сервисов 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, Android Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.3.1
Телефоны, планшеты, устройства Android Go
Блокировка 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.0
Телефоны, планшеты, Android TV, Android 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, Android 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
Fraud Protect
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, Android 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.0
Телефон, планшет
Улучшение медиаэффектов
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08
Телефон, планшет
Студийный звук
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
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
Телефон, планшет
Безопасный просмотр версии 5
com.google.android.gms:play-services-safebrowsing:16.0.0
Телефоны, планшеты, Android TV, Android Auto, Android Go, ChromeOS
API SafetyNet (включая безопасный просмотр и проверку приложений)
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, Android 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 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, Android Auto, Android Go, ChromeOS, Wear OS