Чтобы разработать приложение с использованием 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в каталоге модулей вашего приложения.Для каждого 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 на устройстве, прежде чем пытаться использовать Google API, или включить функции в своем приложении, для работы которых требуются службы Google Play.
Чтобы проверить наличие сервисов Google Play на устройстве, используйте метод isGooglePlayServicesAvailable() .
Чтобы затем начать подключение к службам Google Play или узнать, как определить, поддерживает ли установленная версия служб Google Play определенный API, прочитайте руководство Доступ к API Google .
Зависимости сервисов Google Play
В следующей таблице перечислены зависимости для сервисов Google Play, которые вы можете включить в свое приложение для Android. Вы можете отфильтровать список по типу устройства, выбрав одну из кнопок, и вы можете найти конкретный вариант использования или имя зависимости, введя текст в поле, которое появляется после кнопок.
| Вариант использования и имя зависимости | Поддерживаемые устройства |
|---|---|
Мобильная реклама Googlecom.google.android.gms:play-services-ads:22.1.0 | Телефон, Планшет |
Рекламный идентификатор Android (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 | Телефон, планшет, Android TV, ChromeOS |
Облегченная версия Google Mobile Adscom.google.android.gms:play-services-ads-lite:22.1.0 | Телефон, Планшет |
AdSense для поиска (AFS) Объявления в пользовательском поиске (CSA)com.google.android.gms:play-services-afs-native:19.0.3 | Телефон, планшет, Chrome OS |
SDK сервисов Google Analytics для Androidcom.google.android.gms:play-services-analytics:18.0.2 | Устарело. Вместо этого используйте Google Analytics для Firebase . |
Индекс приложенияcom.google.android.gms:play-services-appindex:16.1.0 | Телефон, Планшет, Андроид ТВ |
Идентификатор набора приложений Androidcom.google.android.gms:play-services-appset:16.0.2 | Телефон, планшет, Android TV, ChromeOS |
Вход в Google для Androidcom.google.android.gms:play-services-auth:20.5.0 | Телефон, планшет, Android TV, авто, Android Go, ChromeOS |
API ретривера SMScom.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 осведомленности Googlecom.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.2.0 | Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.3.0 | Телефон, планшет, Android Go, ChromeOS |
Платформа приложений Google Cast (CAF)com.google.android.gms:play-services-cast-framework:21.3.0 | Телефон, планшет, Android Go, ChromeOS |
Сканер кода Googlecom.google.android.gms:play-services-code-scanner:16.0.0 | Телефон, планшет, 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:20.0.1 | Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS Поддерживается на устройствах под управлением Android 7.0 (уровень API 24) или выше. |
API Google Fit для Androidcom.google.android.gms:play-services-fitness:21.1.0 | Телефон, планшет, Android Go, ChromeOS, Wear OS |
Игровые сервисы Google Play v2 для Androidcom.google.android.gms:play-services-games-v2:17.0.0 | Телефон, планшет, Android TV, Android Go, ChromeOS |
Google Play Games Services 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 v1 для Androidcom.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 Карт для Androidcom.google.android.gms:play-services-maps:18.1.0 | Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS |
Сканирование штрих-кода ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0 | Телефон, планшет, Android Go, ChromeOS |
ML Kit распознавание лицcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 | Телефон, планшет, Android Go, ChromeOS |
Маркировка изображений комплекта MLcom.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-beta4 | Телефон, планшет, Android Go, ChromeOS |
Идентификация языка комплекта MLcom.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 Kit распознавание текстаcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 | Телефон, планшет, Android Go, ChromeOS |
ML Kit для распознавания текста на китайском языкеcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 | Телефон, планшет, Android Go, ChromeOS |
Распознавание текста ML Kit для Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 | Телефон, планшет, Android Go, ChromeOS |
ML Kit для распознавания текста на японском языкеcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 | Телефон, планшет, Android Go, ChromeOS |
ML Kit для распознавания текста на корейском языкеcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 | Телефон, планшет, Android Go, ChromeOS |
Обнаружение устройств поблизости и подключениеcom.google.android.gms:play-services-nearby:18.5.0 | Телефон, планшет, Android TV, авто, Android Go |
Показать лицензии с открытым исходным кодомcom.google.android.gms:play-services-oss-licenses:17.0.1 | Телефон, планшет, 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 |
Диспетчер тегов Googlecom.google.android.gms:play-services-tagmanager:18.0.2 | Телефон, планшет, Android TV, Android Go, ChromeOS |
API задач на Androidcom.google.android.gms:play-services-tasks:18.0.2 | Телефон, планшет, Android TV, авто, Android Go, ChromeOS, Wear OS |
Служба ускорения для Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 | Телефон, планшет, Android Go, ChromeOS |
TensorFlow Lite GPU Delegate API для сервисов Google Playcom.google.android.gms:play-services-tflite-gpu:16.2.0 | Телефон, планшет, Android Go, ChromeOS |
TensorFlow Lite Java API для сервисов Google Playcom.google.android.gms:play-services-tflite-java:16.1.0 | Телефон, планшет, Android Go, ChromeOS |
API поддержки TensorFlow Lite для сервисов Google Playcom.google.android.gms:play-services-tflite-support:16.1.0 | Телефон, планшет, 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 для платежей на Androidcom.google.android.gms:play-services-wallet:19.2.0-beta01 | Телефон, планшет, автомобиль, Android Go, ChromeOS, Wear OS |
API уровня носимых данныхcom.google.android.gms:play-services-wearable:18.0.0 | Телефон, планшет, Wear OS |
Плагины Gradle
Сервисы Google Play также включают в себя несколько подключаемых модулей Gradle, как показано в следующей таблице. Обратите внимание, что кнопки, расположенные перед предыдущей таблицей, не изменяют информацию, отображаемую в этой таблице.
| Пример использования и имя плагина 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 |