Чтобы разработать приложение с использованием API сервисов Google Play , следуйте инструкциям на этой странице, чтобы настроить свой проект с соответствующими пакетами SDK, которые доступны в репозитории Google Maven .
Чтобы протестировать приложение при использовании сервисов Google Play, необходимо использовать один из следующих вариантов:
- Совместимое устройство Android под управлением Android 6.0 (уровень API 23) или выше, на котором установлено приложение Google Play Store.
- Эмулятор Android с AVD , работающий на платформе API Google на базе Android 6.0 (уровень API 23) или выше.
Объявите зависимости для сервисов Google Play
Чтобы разработать в вашем приложении функции, зависящие от API сервисов Google Play, выполните следующие действия:
Откройте файл
build.gradleв каталоге модулей вашего приложения.Для каждого SDK, необходимого вашему приложению, укажите зависимость этого SDK. На этой странице представлен раздел со списком распространённых зависимостей сервисов Google Play для приложений Android. Вы также можете добавить Firebase в свой проект .
Сохраните изменения и синхронизируйте свой проект .
В следующем фрагменте показан пример файла build.gradle , который использует библиотеку location:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
Периодически выпускаются новые версии SDK сервисов Google Play с исправлениями ошибок и новыми функциями. Эти обновления анонсируются в примечаниях к выпуску . Если ваше приложение использует обновлённую зависимость, установите последнюю версию в зависимостях приложения, чтобы воспользоваться этими исправлениями.
Проверьте, установлены ли сервисы Google Play.
Как описано в разделе «Обзор сервисов Google Play» , сервисы Google Play автоматически обновляются на устройствах Android 6.0 (API уровня 23) и выше через приложение Google Play Store. Однако на устройствах без Google Play Store сервисы Google Play не установлены. Если ваше приложение работает на устройствах без сервисов Google Play, перед использованием API Google или включением функций, требующих их, всегда проверяйте, установлены ли сервисы Google Play.
Для проверки наличия сервисов Google Play на устройстве используйте метод isGooglePlayServicesAvailable() .
Чтобы начать подключение к сервисам Google Play или узнать, поддерживает ли установленная версия сервисов Google Play определенный API, ознакомьтесь с руководством по доступу к API Google .
Зависимости сервисов Google Play
В следующей таблице перечислены зависимости сервисов Google Play, которые можно включить в приложение для Android. Вы можете отфильтровать список по типу устройства, нажав одну из кнопок, а также выполнить поиск по конкретному варианту использования или имени зависимости, введя текст в поле, которое появляется после кнопок.
| Имя варианта использования и зависимости | Поддерживаемые устройства |
|---|---|
Мобильная реклама Googlecom.google.android.gms:play-services-ads:24.4.0 | Телефон, планшет |
Рекламный идентификатор Android (AAID)com.google.android.gms:play-services-ads-identifier:18.2.0 | Телефон, планшет, Android TV, ChromeOS |
Облегченная версия Google Mobile Adscom.google.android.gms:play-services-ads-lite:24.3.0 | Телефон, планшет |
AdSense для поиска (AFS) Пользовательские поисковые объявления (CSA)com.google.android.gms:play-services-afs-native:19.1.0 | Телефон, планшет, ChromeOS |
SDK служб Google Analytics для Androidcom.google.android.gms:play-services-analytics:18.1.1 | Устарело. Используйте вместо этого Google Analytics для 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:21.3.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS |
API для извлечения SMScom.google.android.gms:play-services-auth-api-phone:18.2.0 | Телефон, планшет, Android Go |
API Block Store (включает хранилище учетных данных пользователя)com.google.android.gms:play-services-auth-blockstore:16.4.0 | Телефон, планшет, Android Go, ChromeOS |
API Google Awarenesscom.google.android.gms:play-services-awareness:19.1.0 | Телефон, планшет, автомобиль, Android Go, ChromeOS |
Классы полезностиcom.google.android.gms:play-services-base:18.7.2 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Тестирование подделок на классы полезностиcom.google.android.gms:play-services-base-testing:16.1.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Больше полезных классовcom.google.android.gms:play-services-basement:18.7.1 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Улучшение камеры при слабом освещенииcom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta03 | Телефон, планшет |
Google Castcom.google.android.gms:play-services-cast:22.1.0 | Телефон, планшет, Android Go, ChromeOS |
Платформа приложений Google Cast (CAF)com.google.android.gms:play-services-cast-framework:22.1.0 | Телефон, планшет, Android Go, ChromeOS |
Сканер кода Googlecom.google.android.gms:play-services-code-scanner:16.1.0 | Телефон, планшет, Android Go, ChromeOS |
Сетевой стек Chromium (Cronet)com.google.android.gms:play-services-cronet:18.1.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Взаимодействие устройств (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 | Телефон, планшет, Android Go |
Аутентификация Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.2.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS Поддерживается на устройствах под управлением Android 7.0 (уровень API 24) или выше. |
API Google Fit для Android и API записи на мобильных устройствах (для данных о физической форме пользователя)com.google.android.gms:play-services-fitness:21.2.0 | Телефон, планшет, Android Go, ChromeOS, Wear OS |
Игровые сервисы Google Play v2 для Androidcom.google.android.gms:play-services-games-v2:21.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.2.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.1.0 | Телефон, планшет, Android TV, Android Go, ChromeOS Поддерживается на устройствах под управлением Android 5.0 (уровень API 21) или выше. |
Службы определения местоположения для Androidcom.google.android.gms:play-services-location:21.3.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
SDK Google Карт для Androidcom.google.android.gms:play-services-maps:19.2.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Google Maps 3D SDK для Androidcom.google.android.gms:play-services-maps3d:0.0.2 | Телефон, планшет |
Сканирование штрихкода комплектом MLcom.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-beta1 | Телефон, планшет, Android Go, ChromeOS |
ML Kit для распознавания лицcom.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 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.3.0 | Телефон, планшет, Android TV, Авто, Android Go |
Показать лицензии с открытым исходным кодомcom.google.android.gms:play-services-oss-licenses:17.2.1 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS Поддерживается на устройствах под управлением Android 5.0 (уровень API 21) или выше. |
Библиотеки программного доступа (PAL)com.google.android.gms:play-services-pal:22.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 Wallet (ранее Google Pay for Passes)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 |
API SafetyNet (включая безопасный просмотр и проверку приложений)com.google.android.gms:play-services-safetynet:18.1.0 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS |
Менеджер тегов Googlecom.google.android.gms:play-services-tagmanager:18.3.0 | Телефон, планшет, Android TV, Android Go, ChromeOS |
API задач на Androidcom.google.android.gms:play-services-tasks:18.3.2 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Служба ускорения для Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 | Телефон, планшет, Android Go, ChromeOS |
API делегата TensorFlow Lite GPU для сервисов Google Playcom.google.android.gms:play-services-tflite-gpu:16.4.0 | Телефон, планшет, Android Go, ChromeOS |
TensorFlow Lite Java API для сервисов Google Playcom.google.android.gms:play-services-tflite-java:16.4.0 | Телефон, планшет, Android Go, ChromeOS |
API поддержки TensorFlow Lite для сервисов Google Playcom.google.android.gms:play-services-tflite-support:16.4.0 | Телефон, планшет, Android Go, ChromeOS |
API потоковой сетиcom.google.android.gms:play-services-threadnetwork:16.3.0 | Телефон, планшет |
API доверенного времениcom.google.android.gms:play-services-time:16.0.1 | Телефон, планшет, автомобиль, Android Go, Wear OS |
Мобильное видениеcom.google.android.gms:play-services-vision:20.1.3 | Телефон, планшет, Android Go, ChromeOS |
Google Pay для платежей на Androidcom.google.android.gms:play-services-wallet:19.4.0 | Телефон, планшет, автомобиль, Android Go, ChromeOS, Wear OS |
API уровня данных носимых устройствcom.google.android.gms:play-services-wearable:19.0.0 | Телефон, планшет, Wear OS |
Плагины Gradle
Сервисы Google Play также включают несколько плагинов Gradle, как показано в следующей таблице. Обратите внимание, что кнопки, расположенные перед предыдущей таблицей, не изменяют информацию, отображаемую в этой таблице.
| Вариант использования и название плагина Gradle | Поддерживаемые устройства |
|---|---|
Показать лицензии с открытым исходным кодомcom.google.android.gms:oss-licenses-plugin:0.10.6 | Телефон, планшет, ChromeOS |
Строгая проверка версийcom.google.android.gms:strict-version-matcher-plugin:1.2.4 | Телефон, планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |