如需使用 Google Play 服务 API 开发应用，请按照本页上的说明使用相关 SDK 设置 项目，这些 SDK 可从 Google Maven 代码库获取。
如需在使用 Google Play 服务时测试应用，您必须使用以下其中一项：
- 兼容的 Android 设备，搭载 Android 6.0（API 级别 23）或更高版本，并且安装了 Google Play 商店应用。
- Android 模拟器，其中包含基于 Android 6.0（API 级别 23）或更高版本运行 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.3.0'
}
我们定期发布新版本的 Google Play 服务 SDK，其中包含 bug 修复和新功能。这些更新会在版本 说明中公布。如果您的应用使用的依赖项已更新，请在应用的依赖项中更改为最新版本，以利用这些修复。
检查是否安装了 Google Play 服务
如 Google Play 服务概览 中所述，Google Play 服务会在 Android 6.0（API 级别 23）及更高版本上 通过 Google Play 商店应用自动更新。不过，没有 Google Play 商店的设备不会安装 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:25.1.0 |
手机、平板电脑 |
Android 广告 ID (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
手机、平板电脑、Android TV、ChromeOS |
Google 移动广告的轻量级版本com.google.android.gms:play-services-ads-lite:24.8.0 |
手机、平板电脑 |
AdSense 搜索广告 (AFS) 自定义搜索广告 (CSA)com.google.android.gms:play-services-afs-native:19.1.0 |
手机、平板电脑、ChromeOS |
适用于 Android 的 Google Analytics 服务 SDKcom.google.android.gms:play-services-analytics:18.1.1 |
已弃用。请改用 Google Analytics for 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 |
Android 应用组 IDcom.google.android.gms:play-services-appset:16.1.0 |
手机、平板电脑、Android TV、ChromeOS |
适用于 Android 的 Google 登录com.google.android.gms:play-services-auth:21.5.1 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS |
短信检索器 APIcom.google.android.gms:play-services-auth-api-phone:18.3.0 |
手机、平板电脑、Android Go |
Block Store API（包括用户凭证存储空间）com.google.android.gms:play-services-auth-blockstore:16.4.0 |
手机、平板电脑、Android Go、ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:20.0.0 |
手机、平板电脑、Auto、Android Go、ChromeOS |
实用工具类com.google.android.gms:play-services-base:18.10.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
实用工具类的测试替身com.google.android.gms:play-services-base-testing:16.2.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
更多实用工具类com.google.android.gms:play-services-basement:18.10.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
相机弱光增强com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07 |
手机、平板电脑 |
Google Castcom.google.android.gms:play-services-cast:22.3.0 |
手机、平板电脑、Android Go、ChromeOS |
Google Cast 应用框架 (CAF)com.google.android.gms:play-services-cast-framework:22.3.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.1 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
设备间互动 (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
手机、平板电脑、Android Go |
Key Verifier SDKcom.google.android.gms:contactkeys:16.0.0 |
手机、平板电脑 |
线上快速身份验证 (FIDO) 身份验证com.google.android.gms:play-services-fido:21.2.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS 支持搭载 Android 7.0（API 级别 24）或更高版本的设备。 |
适用于 Android 的 Google 健身 API 和 移动设备上的 Recording API（用于用户健身数据）com.google.android.gms:play-services-fitness:21.3.0 |
手机、平板电脑、Android Go、ChromeOS、Wear OS |
适用于 Android 的 Google Play 游戏服务 v2com.google.android.gms:play-services-games-v2:21.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:24.0.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.2.0 |
已弃用。如需了解详情，请参阅 Google Play 免安装体验。 |
适用于 Android 的位置信息服务com.google.android.gms:play-services-location:21.3.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
适用于 Android 的 Maps SDKcom.google.android.gms:play-services-maps:20.0.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
适用于 Android 的 Google 地图 3D SDKcom.google.android.gms:play-services-maps3d:0.2.0 |
手机、平板电脑 |
媒体效果增强com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta03 |
手机、平板电脑 |
机器学习套件条形码扫描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 |
手机、平板电脑、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.4.0 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS 支持搭载 Android 5.0（API 级别 21）或更高版本的设备。 |
Programmatic Access Libraries (PAL)com.google.android.gms:play-services-pal:23.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 钱包（以前称为 Google Pay for Passes）com.google.android.gms:play-services-pay:16.5.0 |
手机、平板电脑、Android Go、ChromeOS 支持搭载 Android 5.0（API 级别 20）或更高版本的设备。 |
适用于应用插桩的 reCAPTCHA Enterprisecom.google.android.gms:play-services-recaptcha:17.1.0 |
手机、平板电脑、Android TV、Android Go、ChromeOS |
SafetyNet API（包括安全浏览和验证应用）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.3.0 |
手机、平板电脑、Android TV、Android Go、ChromeOS |
Android 上的 Tasks APIcom.google.android.gms:play-services-tasks:18.4.1 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |
适用于 Android 的加速服务com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
手机、平板电脑、Android Go、ChromeOS |
适用于 Google Play 服务的 TensorFlow Lite GPU 委托 APIcom.google.android.gms:play-services-tflite-gpu:16.4.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于 Google Play 服务的 TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.4.0 |
手机、平板电脑、Android Go、ChromeOS |
适用于 Google Play 服务的 TensorFlow Lite 支持 APIcom.google.android.gms:play-services-tflite-support:16.4.0 |
手机、平板电脑、Android Go、ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.3.0 |
手机、平板电脑 |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
手机、平板电脑、Auto、Android Go、Wear OS |
移动视觉com.google.android.gms:play-services-vision:20.1.3 |
手机、平板电脑、Android Go、ChromeOS |
适用于 Android 支付的 Google Paycom.google.android.gms:play-services-wallet:19.5.0 |
手机、平板电脑、Auto、Android Go、ChromeOS、Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.0 |
手机、平板电脑、Wear OS |
Gradle 插件
Google Play 服务还包含多个 Gradle 插件，如下表所示。请注意，上表前显示的按钮不会更改此表中显示的信息。
| 用例和 Gradle 插件名称 | 支持的设备 |
|---|---|
显示开源许可com.google.android.gms:oss-licenses-plugin:0.11.0 |
手机、平板电脑、ChromeOS |
严格的版本检查com.google.android.gms:strict-version-matcher-plugin:1.2.4 |
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS |