Чтобы разработать приложение с помощью 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, выполните следующие действия:
Откройте файл
build.gradleв каталоге модулей приложения.Для каждого SDK, который требуется вашему приложению, добавьте зависимость. На этой странице есть раздел, в котором перечислены распространенные зависимости сервисов Google Play для приложений Android. Вы также можете добавить Firebase в свой проект.
Сохраните изменения и синхронизируйте проект.
Ниже приведен пример файла 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. Вы можете отфильтровать список по типу устройства, нажав одну из кнопок, и выполнить поиск по конкретному варианту использования или названию зависимости, введя текст в поле, которое появится после кнопок.
| Название варианта использования и зависимости | Поддерживаемые устройства |
|---|---|
Google Mobile Adscom.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 Adscom.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 для Androidcom.google.android.gms:play-services-analytics:18.1.1 |
Поддержка прекращена. Вместо этого используйте Google Аналитику для Firebase. |
Индекс приложенийcom.google.android.gms:play-services-appindex:16.2.0 |
Телефон, планшет, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Телефон, планшет, Android TV |
Идентификатор набора приложений для Androidcom.google.android.gms:play-services-appset:16.1.0 |
Телефон, планшет, Android TV, ChromeOS |
Вход с аккаунтом Google для Androidcom.google.android.gms:play-services-auth:22.0.0 |
Телефоны, планшеты, Android TV, Android Auto, Android Go, ChromeOS |
SMS Retriever APIcom.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 APIcom.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 Castcom.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 Scannercom.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 SDKcom.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 Protectcom.google.android.gms:play-services-fraudprotect:16.0.1 |
Телефоны, планшеты, устройства Android Go |
Сервисы Google Play Games версии 2 для Androidcom.google.android.gms:play-services-games-v2:22.1.0 |
Телефоны, планшеты, Android TV, Android Go, ChromeOS |
Сервисы Google Play Games v2 Native C SDK для Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Телефоны, планшеты, Android TV, Android Go, ChromeOS |
Сервисы Google Play Games версии 1 для Androidcom.google.android.gms:play-services-games:25.0.0 |
Поддержка прекращена. Используйте сервисы Google Play Games версии 2. |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
Телефон, планшет |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.2.0 |
Поддержка прекращена. Подробнее о Google Play Instant… |
Геолокация для Androidcom.google.android.gms:play-services-location:21.4.0 |
Телефоны, планшеты, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Google Maps SDK для Androidcom.google.android.gms:play-services-maps:20.1.0 |
Телефон, планшет, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Карты 3D SDK для Androidcom.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 Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Телефон, планшет, Android Go, ChromeOS |
Сканер документов ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 |
Телефон, планшет, Android Go, ChromeOS |
Распознавание лиц с помощью ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Телефон, планшет, Android Go, ChromeOS |
Добавление ярлыков к изображениям с помощью ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Телефон, планшет, Android Go, ChromeOS |
Пользовательская маркировка изображений с помощью ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Телефоны, планшеты, Android Go, ChromeOS |
Определение языка с помощью ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Телефоны, планшеты, Android Go, ChromeOS |
Быстрый ответ ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Телефоны, планшеты, Android Go, ChromeOS |
Сегментирование объектов с помощью ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Телефон, планшет, Android Go, ChromeOS |
Распознавание текста с помощью ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Телефон, планшет, Android Go, ChromeOS |
Распознавание текста на китайском языке с помощью ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
Телефон, планшет, Android Go, ChromeOS |
Распознавание текста на деванагари с помощью ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
Телефон, планшет, Android Go, ChromeOS |
Распознавание текста на японском языке с помощью ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
Телефон, планшет, Android Go, ChromeOS |
Распознавание текста на корейском языке с помощью ML Kitcom.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 APIcom.google.android.gms:play-services-remotegestures:16.0.0 |
Телефон, планшет |
Безопасный просмотр версии 5com.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 для Androidcom.google.android.gms:play-services-tasks:18.4.1 |
Телефоны, планшеты, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Acceleration Service for Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02 |
Телефоны, планшеты, Android Go, ChromeOS |
TensorFlow Lite GPU Delegate API для сервисов Google Playcom.google.android.gms:play-services-tflite-gpu:16.5.0 |
Телефоны, планшеты, Android Go, ChromeOS |
TensorFlow Lite Java API для сервисов Google Playcom.google.android.gms:play-services-tflite-java:16.5.0 |
Телефон, планшет, Android Go, ChromeOS |
TensorFlow Lite Support API для сервисов Google Playcom.google.android.gms:play-services-tflite-support:16.5.0 |
Телефон, планшет, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Телефон, планшет |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
Телефон, планшет, Android Auto, Android Go, Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
Телефон, планшет, Android Go, ChromeOS |
Google Pay для платежей на Androidcom.google.android.gms:play-services-wallet:20.0.0 |
Телефоны, планшеты, автомобили, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:20.0.1 |
Телефон, планшет, Wear OS |
Плагины Gradle
Сервисы Google Play также включают несколько плагинов Gradle, как показано в таблице ниже. Обратите внимание, что кнопки, которые появляются перед предыдущей таблицей, не меняют информацию в этой таблице.
| Вариант использования и название плагина 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 |