设置 Google Play 服务

使用 Google Play 服务开发应用 API”部分,请按照本页面中的说明设置 为您的项目设置相关 SDK,您可以在 Google Maven 代码库

要在使用 Google Play 服务时测试您的应用,您必须使用 以下:

  • 搭载 Android 6.0 (API) 的兼容 Android 设备 级别 23)或更高级别,并且安装了 Google Play 商店应用 已安装。
  • 带有 运行 Google API 的 AVD 基于 Android 6.0(API 级别 23)或更高版本的 Android 平台。

声明 Google Play 服务的依赖项

如需在应用中开发依赖于 Google Play 服务 API 的功能, 请完成以下步骤:

  1. 打开应用的模块目录中的 build.gradle 文件。

  2. 对于应用所需的每个 SDK,请添加相应 SDK 的依赖项。 本页中列出了一些常用的 Google Play 服务 依赖项。您可能还需要将 Firebase 依赖项 项目

  3. 保存更改并同步 项目

以下代码段显示了一个示例 build.gradle 文件,该文件使用 位置库:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

新版 Google Play 服务 SDK,修复了一些问题并增加了新功能 定期发布这些更新会在 备注。如果您的应用使用的依赖项已被 更新到应用依赖项中的最新版本 充分利用这些修复

检查是否已安装 Google Play 服务

Google Play 服务概览中所述, Google Play 服务会在 Android 设备上收到自动更新 6.0(API 级别 23)及更高版本 。不过,未安装 Google Play 的 Android 设备 商店未安装 Google Play 服务。如果您的应用在设备上运行 则您可能要检查 Google Play 是否 服务,或者 在您的应用中启用需要 Google Play 服务才能正常运行的功能。

要检查设备上是否存在 Google Play 服务,请使用 isGooglePlayServicesAvailable() 方法。

然后开始连接到 Google Play 服务,或了解如何检测 安装的 Google Play 服务版本是否支持特定 API; 阅读有关访问 Google API 的指南。

Google Play 服务依赖项

下表列出了 Google Play 服务的依赖项, 添加在 Android 应用中您可以按设备类型过滤列表 还可以搜索特定的应用场景或依赖项 在按钮后显示的框中输入文本。

表 1. 要包含的 Google Play 服务依赖项 Android 应用
用例和依赖项名称 支持的设备
Google 移动广告
com.google.android.gms:play-services-ads:23.3.0
手机、平板电脑
Android 广告 ID (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
手机、平板电脑、Android TV、ChromeOS
简化版 Google 移动广告
com.google.android.gms:play-services-ads-lite:23.3.0
手机、平板电脑
AdSense 搜索广告 (AFS) 自定义搜索广告 (CSA)
com.google.android.gms:play-services-afs-native:19.1.0
手机、平板电脑、ChromeOS
Android 版 Google Analytics 服务 SDK
com.google.android.gms:play-services-analytics:18.1.0
已弃用。请改用 Google Analytics for Firebase
应用索引
com.google.android.gms:play-services-appindex:16.2.0
手机、平板电脑、Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.0
手机、平板电脑、Android TV
Android 应用集 ID
com.google.android.gms:play-services-appset:16.1.0
手机、平板电脑、Android TV、ChromeOS
Android 版 Google 登录功能
com.google.android.gms:play-services-auth:21.2.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
手机、平板电脑、Android Go
Block Store API(包括用户凭据存储)
com.google.android.gms:play-services-auth-blockstore:16.4.0
手机、平板电脑、Android Go、ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
手机、平板电脑、Auto、Android Go、ChromeOS
实用程序类
com.google.android.gms:play-services-base:18.5.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
测试实用程序类的虚假对象
com.google.android.gms:play-services-base-testing:16.1.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
更多实用程序类
com.google.android.gms:play-services-basement:18.4.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.5.0
手机、平板电脑、Android Go、ChromeOS
Google Cast 应用框架 (CAF)
com.google.android.gms:play-services-cast-framework:21.5.0
手机、平板电脑、Android Go、ChromeOS
Google 扫码器
com.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、Auto、Android Go、ChromeOS、Wear OS
设备到设备交互 (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
手机、平板电脑、Android Go
快速 ID 实体在线 (FIDO) 身份验证
com.google.android.gms:play-services-fido:21.1.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS

在搭载 Android 7.0(API 级别 24)或更高版本的设备上受支持。
Android 版 Google Fit API移动设备上的 Recording API(用于收集用户健身数据)
com.google.android.gms:play-services-fitness:21.2.0
手机、平板电脑、Android Go、ChromeOS、Wear OS
适用于 Android 的 Google Play 游戏服务 v2
com.google.android.gms:play-services-games-v2:20.1.2
手机、平板电脑、Android TV、Android Go、ChromeOS
适用于 Android 的 Google Play 游戏服务 v2 原生 C SDK
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
手机、平板电脑、Android TV、Android Go、ChromeOS
适用于 Android 的 Google Play 游戏服务 v1
com.google.android.gms:play-services-games:23.2.0
手机、平板电脑、Android TV、Android Go、ChromeOS
Matter 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)或更高版本的设备上受支持。
适用于 Android 的位置信息服务
com.google.android.gms:play-services-location:21.3.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
Google Maps SDK for Android
com.google.android.gms:play-services-maps:19.0.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
机器学习套件条形码扫描
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
手机、平板电脑、Android Go、ChromeOS
机器学习套件文档扫描器
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
手机、平板电脑、Android Go、ChromeOS
机器学习套件人脸检测
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
手机、平板电脑、Android Go、ChromeOS
机器学习套件图片标签
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
手机、平板电脑、Android Go、ChromeOS
机器学习套件图片标签自定义
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
手机、平板电脑、Android Go、ChromeOS
机器学习套件语言识别
com.google.android.gms:play-services-mlkit-language-id:17.0.0
手机、平板电脑、Android Go、ChromeOS
机器学习套件智能回复
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
手机、平板电脑、Android Go、ChromeOS
机器学习套件主题细分
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
手机、平板电脑、Android Go、ChromeOS
机器学习套件文本识别
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
手机、平板电脑、Android Go、ChromeOS
机器学习套件文本识别(中文版)
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
手机、平板电脑、Android Go、ChromeOS
适用于梵文的机器学习套件文本识别
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
手机、平板电脑、Android Go、ChromeOS
机器学习套件文本识别(日语版)
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
手机、平板电脑、Android Go、ChromeOS
韩语机器学习套件文本识别
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、Auto、Android Go
显示开源许可
com.google.android.gms:play-services-oss-licenses:17.1.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS
在搭载 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 for Passs)
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
SafetyNet API(包括设备认证、安全浏览、reCAPTCHA 和应用验证)
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.1.0
手机、平板电脑、Android TV、Android Go、ChromeOS
Android 上的 Tasks API
com.google.android.gms:play-services-tasks:18.2.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
适用于 Android 的加速服务
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
手机、平板电脑、Android Go、ChromeOS
适用于 Google Play 服务的 TensorFlow Lite GPU Delegate API
com.google.android.gms:play-services-tflite-gpu:16.2.0
手机、平板电脑、Android Go、ChromeOS
适用于 Google Play 服务的 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
手机、平板电脑、Android Go、ChromeOS
适用于 Google Play 服务的 TensorFlow Lite Support API
com.google.android.gms:play-services-tflite-support:16.1.0
手机、平板电脑、Android Go、ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.1
手机、平板电脑
移动愿景
com.google.android.gms:play-services-vision:20.1.3
手机、平板电脑、Android Go、ChromeOS
Android 版 Google Pay for Payments
com.google.android.gms:play-services-wallet:19.4.0
手机、平板电脑、Auto、Android Go、ChromeOS、Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.2.0
手机、平板电脑、Wear OS

Gradle 插件

Google Play 服务还包含几个 Gradle 插件,如 表格。请注意,上一个表格前面显示的按钮 不会更改此表格中显示的信息。

表格 2. 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、Auto、Android Go、ChromeOS、Wear OS