如需使用 Google Play Services API 开发应用，请按照本页面中的说明操作，使用 Google Maven 代码库中提供的相关 SDK 设置您的项目。
如需在使用 Google Play 服务时测试应用，您必须执行以下操作之一：
- 搭载 Android 4.4（API 级别 19）或更高版本且安装了 Google Play 商店应用的兼容 Android 设备。
- Android 模拟器，带有搭载基于 Android 4.4（API 级别 19）或更高版本的 Google API 平台的 AVD。
声明 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。这些更新会在版本说明中公布。如果您的应用使用的依赖项已更新，您可以切换到应用依赖项中的最新版本以利用这些修复。
检查是否已安装 Google Play 服务
如 Google Play 服务概览中所述，Google Play 服务会在 Android 4.4（API 级别 19）及更高版本上通过 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 服务依赖项
下表列出了您可以在 Android 应用中包含的 Google Play 服务的依赖项。您可以选择其中一个按钮来按设备类型过滤列表，也可以通过在按钮后面的框中输入文本来搜索特定的用例或依赖项名称。
| 用例和依赖项名称 | 支持的设备 |
|---|---|
Google 移动广告com.google.android.gms:play-services-ads:22.0.0 |
手机、平板电脑 |
Android 广告 ID (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
手机、平板电脑、Android TV、Chrome 操作系统 |
轻型版 Google 移动广告com.google.android.gms:play-services-ads-lite:22.0.0 |
手机、平板电脑 |
AdSense 搜索广告 (AFS) 自定义搜索广告 (CSA)com.google.android.gms:play-services-afs-native:19.0.3 |
手机、平板电脑、Chrome 操作系统 |
Android 版 Google Analytics（分析）服务 SDKcom.google.android.gms:play-services-analytics:18.0.2 |
已弃用。请改用 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、Chrome 操作系统 |
Android 版 Google 登录com.google.android.gms:play-services-auth:20.4.1 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统 |
短信检索器 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、Chrome 操作系统 |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
手机、平板电脑、Android Auto、Android Go、Chrome 操作系统 |
实用工具类com.google.android.gms:play-services-base:18.2.0 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |
测试实用程序类的虚假项com.google.android.gms:play-services-base-testing:16.0.0 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |
更多实用程序类com.google.android.gms:play-services-basement:18.2.0 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.3.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
Google Cast 应用框架 (CAF)com.google.android.gms:play-services-cast-framework:21.3.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
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.0.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
Chromium 网络堆栈 (Cronet)com.google.android.gms:play-services-cronet:18.0.1 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |
设备间互动 (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
手机、平板电脑、Android Go |
快速 IDentity Online (FIDO) 身份验证com.google.android.gms:play-services-fido:19.0.1 |
手机、平板电脑、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、Chrome 操作系统、Wear OS |
Android 版 Google Play 游戏服务 v2com.google.android.gms:play-services-games-v2:17.0.0 |
手机、平板电脑、Android TV、Android Go、Chrome 操作系统 |
Android 版 Google Play 游戏服务 v2 原生 C SDKcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
手机、平板电脑、Android TV、Android Go、Chrome 操作系统 |
Android 版 Google Play 游戏服务 v1com.google.android.gms:play-services-games:23.1.0 |
手机、平板电脑、Android TV、Android Go、Chrome 操作系统 |
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, Chrome 操作系统, Wear OS |
Google Maps SDK for Androidcom.google.android.gms:play-services-maps:18.1.0 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |
机器学习套件条形码扫描com.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
机器学习套件人脸检测com.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
机器学习套件图片标签com.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
手机、平板电脑、Android Go、Chrome 操作系统 |
机器学习套件图片标签自定义com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4 |
手机、平板电脑、Android Go、Chrome 操作系统 |
机器学习套件语言识别com.google.android.gms:play-services-mlkit-language-id:17.0.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
机器学习套件智能回复com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
手机、平板电脑、Android Go、Chrome 操作系统 |
机器学习套件文本识别com.google.android.gms:play-services-mlkit-text-recognition:18.0.2 |
手机、平板电脑、Android Go、Chrome 操作系统 |
发现附近的设备并建立连接com.google.android.gms:play-services-nearby:18.5.0 |
手机、平板电脑、Android TV、Auto、Android Go |
显示开源许可com.google.android.gms:play-services-oss-licenses:17.0.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS 适用于搭载 Android 5.0（API 级别 21）或更高版本的设备。 |
屏幕锁定质量检查 com.google.android.gms:play-services-password-complexity:18.0.1 |
手机、平板电脑、Android Go、Chrome 操作系统、Wear OS 适用于搭载 Android 4.4（API 级别 19）到 Android 9（API 级别 28）的设备。 |
Google Pay for Passescom.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、Chrome 操作系统 |
SafetyNet API（包括设备认证、安全浏览、reCAPTCHA 和应用验证）com.google.android.gms:play-services-safetynet:18.0.1 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统 |
Google 跟踪代码管理器com.google.android.gms:play-services-tagmanager:18.0.2 |
手机、平板电脑、Android TV、Android Go、Chrome 操作系统 |
Android 上的 Tasks APIcom.google.android.gms:play-services-tasks:18.0.2 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |
适用于 Google Play 服务的 TensorFlow Lite GPU Delegate APIcom.google.android.gms:play-services-tflite-gpu:16.1.0 |
手机、平板电脑、Android Go、Chrome 操作系统 |
适用于 Google Play 服务的 TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.0.1 |
手机、平板电脑、Android Go、Chrome 操作系统 |
适用于 Google Play 服务的 TensorFlow Lite Support APIcom.google.android.gms:play-services-tflite-support:16.0.1 |
手机、平板电脑、Android Go、Chrome 操作系统 |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0 |
手机、平板电脑 |
移动视觉com.google.android.gms:play-services-vision:20.1.3 |
手机、平板电脑、Android Go、Chrome 操作系统 |
Android 上的 Google Pay 付款com.google.android.gms:play-services-wallet:19.1.0 |
手机, 平板电脑, Auto, Android Go, Chrome 操作系统, Wear OS |
Wearable Data Layer APIcom.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 操作系统 |
严格的版本检查com.google.android.gms:strict-version-matcher-plugin:1.2.4 |
手机, 平板电脑, Android TV, Auto, Android Go, Chrome 操作系统, Wear OS |