Настройка служб 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, Android 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 Go, ChromeOS
Вспомогательные классы
com.google.android.gms:play-services-base:18.11.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.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
Взаимодействия между устройствами (DTDI)
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.0.0
Телефоны, планшеты, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
Google Карты 3D SDK для Android
com.google.android.gms:play-services-maps3d:0.2.2
Телефон, планшет
Улучшение медиаэффектов
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, Android 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
Сервис ускорения для 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, Auto, Android Go, ChromeOS, Wear OS