Чтобы разработать приложение с использованием API сервисов Google Play , следуйте инструкциям на этой странице, чтобы настроить свой проект с помощью соответствующих SDK, которые доступны в репозитории Google Maven .
Чтобы протестировать свое приложение при использовании сервисов Google Play, необходимо использовать один из следующих вариантов:
- Совместимое устройство Android под управлением Android 6.0 (уровень API 23) или выше с установленным приложением Google Play Store.
- Эмулятор Android с AVD , работающий на платформе Google API на базе 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. Однако на устройствах 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. Вы можете отфильтровать список по типу устройства, выбрав одну из кнопок, и вы можете выполнить поиск по определенному варианту использования или имени зависимости, введя текст в поле, которое появляется после кнопок.
| Имя варианта использования и зависимости | Поддерживаемые устройства |
|---|---|
Мобильная реклама Googlecom.google.android.gms:play-services-ads:24.2.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.0.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 Осведомленностиcom.google.android.gms:play-services-awareness:19.1.0 | Телефон, Планшет, Авто, Android Go, ChromeOS |
Классы полезностиcom.google.android.gms:play-services-base:18.7.0 | Телефон, Планшет, 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.0 | Телефон, Планшет, Android TV, Авто, Android Go, ChromeOS, Wear OS |
Усиление камеры при слабом освещенииcom.google.android.gms:play-services-camera-low-light-boost:16.0.0-beta01 | Телефон, Планшет |
Google Кастcom.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) или выше. |
Google Fit API для 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:20.1.2 | Телефон, планшет, 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 |
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-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 Kit маркировка изображений на заказcom.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 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.3.0 | Телефон, Планшет, Android TV, Авто, Android Go |
Показать лицензии с открытым исходным кодомcom.google.android.gms:play-services-oss-licenses:17.1.0 | Телефон, Планшет, 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.0 | Телефон, Планшет, 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.2.1 | Телефон, Планшет |
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 |