Эта страница переведена с помощью Cloud Translation API.

Настроить сервисы 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 в вашем приложении, выполните следующие действия:

Откройте файл build.gradle в каталоге модулей вашего приложения.
Примечание. Проекты Android Studio содержат файл build.gradle верхнего уровня и файл build.gradle для каждого модуля. Обязательно отредактируйте файл для модуля вашего приложения. Узнайте больше о создании проекта с помощью Gradle .
Для каждого SDK, который требуется вашему приложению, включите зависимость для этого SDK. На этой странице есть раздел, в котором перечислены общие зависимости сервисов Google Play для приложений Android. Вы также можете добавить зависимости Firebase в свой проект .
Сохраните изменения и синхронизируйте свой проект .

В следующем фрагменте показан пример файла 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 на устройстве, прежде чем пытаться использовать 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:21.5.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:21.5.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.4.1`	Телефон, планшет, 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.1.0`	Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS
Google Cast `com.google.android.gms:play-services-cast:21.2.0`	Телефон, планшет, Android Go, ChromeOS
Платформа приложений Google Cast (CAF) `com.google.android.gms:play-services-cast-framework:21.2.0`	Телефон, планшет, Android Go, ChromeOS
Сканер кода Google `com.google.android.gms:play-services-code-scanner:16.0.0-beta3`	Телефон, планшет, 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:19.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.1.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:18.0.2`	Телефон, планшет, Android Go, ChromeOS
Обнаружение устройств поблизости и подключение `com.google.android.gms:play-services-nearby:18.4.0`	Телефон, планшет, Android TV, авто, Android Go
Показать лицензии с открытым исходным кодом `com.google.android.gms:play-services-oss-licenses:17.0.0`	Телефон, планшет, 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
TensorFlow Lite GPU Delegate API для сервисов Google Play `com.google.android.gms:play-services-tflite-gpu:16.1.0`	Телефон, планшет, Android Go, ChromeOS
TensorFlow Lite Java API для сервисов Google Play `com.google.android.gms:play-services-tflite-java:16.0.1`	Телефон, планшет, Android Go, ChromeOS
API поддержки TensorFlow Lite для сервисов Google Play `com.google.android.gms:play-services-tflite-support:16.0.1`	Телефон, планшет, 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.1.0`	Телефон, планшет, автомобиль, 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