如需使用 Google Play 服务 API 开发应用,请按照本页面中的说明使用 Google Maven 制品库中的相关 SDK 设置项目。
如需在使用 Google Play 服务时测试应用,您必须使用以下任一工具:
- 搭载 Android 5.0(API 级别 21)或更高版本且已安装 Google Play 商店应用的兼容 Android 设备。
- 具有 AVD 的 Android 模拟器,该 AVD 运行基于 Android 5.0(API 级别 21)或更高版本的 Google API 平台。
声明 Google Play 服务的依赖项
如需开发应用中依赖于 Google Play 服务 API 的功能,请完成以下步骤:
打开应用的模块目录中的
build.gradle
文件。对于应用所需的每个 SDK,请添加相应 SDK 的依赖项。本页中有一个部分列出了 Android 应用的常见 Google Play 服务依赖项。您可能还需要将 Firebase 依赖项添加到项目中。
保存更改并同步您的项目。
以下代码段展示了一个使用位置库的 build.gradle
文件示例:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.0.1'
}
我们会定期发布新版本的 Google Play 服务 SDK,其中包含 bug 修复和新功能。这些更新将在版本说明中公布。如果您的应用使用的依赖项已更新,请在应用的依赖项中将其更改为最新版本,以充分利用这些修复。
检查是否已安装 Google Play 服务
如 Google Play 服务概览中所述,在 Android 5.0(API 级别 21)及更高版本上,Google Play 服务会通过 Google Play 商店应用接收自动更新。不过,没有安装 Google Play 商店的 Android 设备不会安装 Google Play 服务。如果您的应用在没有 Google Play 服务的设备上运行,那么您可能需要先检查设备上是否已安装 Google Play 服务,然后再尝试使用 Google API;或者在应用中启用需要 Google Play 服务才能正常运行的功能。
如需检查设备上是否存在 Google Play 服务,请使用 isGooglePlayServicesAvailable()
方法。
然后,如需开始连接到 Google Play 服务,或了解如何检测已安装的 Google Play 服务版本是否支持特定 API,请参阅访问 Google API 指南。
Google Play 服务依赖项
下表列出了您可以将 Google Play 服务添加到自己的 Android 应用中的依赖项。您可以通过选择一个按钮来按设备类型过滤列表,也可以在按钮后面的框中输入文本,以搜索特定用例或依赖项名称。
用例和依赖项名称 | 支持的设备 |
---|---|
Google 移动广告com.google.android.gms:play-services-ads:22.4.0 |
手机、平板电脑 |
Android 广告 ID (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
手机、平板电脑、Android TV、ChromeOS |
精简版 Google 移动广告com.google.android.gms:play-services-ads-lite:22.4.0 |
手机、平板电脑 |
AdSense 搜索广告 (AFS) 自定义搜索广告 (CSA)com.google.android.gms:play-services-afs-native:19.0.3 |
手机、平板电脑、ChromeOS |
Android 版 Google Analytics(分析)服务 SDKcom.google.android.gms:play-services-analytics:18.0.3 |
已弃用。请改用 Google Analytics for Firebase。 |
应用索引com.google.android.gms:play-services-appindex:16.1.0 |
手机、平板电脑、Android TV |
Android 应用组 IDcom.google.android.gms:play-services-appset:16.0.2 |
手机、平板电脑、Android TV、ChromeOS |
Android 版 Google 登录com.google.android.gms:play-services-auth:20.7.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.0.1 |
手机、平板电脑、Android Go |
Block Store API(包括用户凭据存储)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
手机、平板电脑、Android Go、ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
手机、平板电脑、Auto、Android Go、ChromeOS |
实用程序类com.google.android.gms:play-services-base:18.2.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
测试实用程序类的虚假对象com.google.android.gms:play-services-base-testing:16.0.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
更多实用程序类com.google.android.gms:play-services-basement:18.2.0 |
手机、平板电脑、Android TV、Auto、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 |
Android TV 接收器com.google.android.gms:play-services-cast-tv:21.0.0 |
Android TV |
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.0.1 |
手机、平板电脑、Android TV、Auto、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.1.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS 在搭载 Android 7.0(API 级别 24)或更高版本的设备上受支持。 |
Android 版 Google Fit APIcom.google.android.gms:play-services-fitness:21.1.0 |
手机、平板电脑、Android Go、ChromeOS、Wear OS |
Android 版 Google Play 游戏服务 v2com.google.android.gms:play-services-games-v2:19.0.0 |
手机、平板电脑、Android TV、Android Go、ChromeOS |
适用于 Android 的 Google Play 游戏服务 v2 原生 C SDKcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
手机、平板电脑、Android TV、Android Go、ChromeOS |
Android 版 Google Play 游戏服务 v1com.google.android.gms:play-services-games:23.1.0 |
手机、平板电脑、Android TV、Android Go、ChromeOS |
Matter APIcom.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)或更高版本的设备上受支持。 |
适用于 Android 的一体化位置信息提供程序(包括运动状态识别和地理围栏)com.google.android.gms:play-services-location:21.0.1
| 手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Google Maps SDK for Androidcom.google.android.gms:play-services-maps:18.1.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
机器学习套件条形码扫描com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0 |
手机、平板电脑、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-beta4 |
手机、平板电脑、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-text-recognition:19.0.0 |
手机、平板电脑、Android Go、ChromeOS |
中文机器学习套件文本识别com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于梵文的机器学习套件文本识别com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于日语的机器学习套件文本识别com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于韩语的机器学习套件文本识别com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
手机、平板电脑、Android Go、ChromeOS |
附近的设备发现和连接com.google.android.gms:play-services-nearby:19.0.0 |
手机、平板电脑、Android TV、Auto、Android Go |
显示开源许可com.google.android.gms:play-services-oss-licenses:17.0.1 |
手机、平板电脑、Android TV、Auto、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 for Passscom.google.android.gms:play-services-pay:16.3.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 |
SafetyNet API(包括设备认证、安全浏览、reCAPTCHA 和应用验证)com.google.android.gms:play-services-safetynet:18.0.1 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS |
Google 跟踪代码管理器com.google.android.gms:play-services-tagmanager:18.0.3 |
手机、平板电脑、Android TV、Android Go、ChromeOS |
Android 上的 Tasks APIcom.google.android.gms:play-services-tasks:18.0.2 |
手机、平板电脑、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 代理 APIcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于 Google Play 服务的 TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.1.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于 Google Play 服务的 TensorFlow Lite Support APIcom.google.android.gms:play-services-tflite-support:16.1.0 |
手机、平板电脑、Android Go、ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0 |
手机、平板电脑 |
移动视觉com.google.android.gms:play-services-vision:20.1.3 |
手机、平板电脑、Android Go、ChromeOS |
Android 上的 Google Pay for Paymentscom.google.android.gms:play-services-wallet:19.2.1 |
手机、平板电脑、Auto、Android Go、ChromeOS、Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.1.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、Auto、Android Go、ChromeOS、Wear OS |