设置 Google Play 服务

如需使用 Google Play 服务 API 开发应用,请按照本页中的说明,使用相关 SDK 设置项目,这些 SDK 可从 Google Maven 制品库中获取。

如需在使用 Google Play 服务时测试应用,您必须使用以下任一设备:

  • 搭载 Android 7.0(API 级别 24)或更高版本且已安装 Google Play 商店应用的兼容 Android 设备。
  • Android 模拟器,具有运行基于 Android 7.0(API 级别 24)或更高版本的 Google API 平台的 AVD。

声明 Google Play 服务的依赖项

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

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

  2. 对于应用所需的每个 SDK,请添加该 SDK 的依赖项。 本页包含一个部分,其中列出了 Android 应用的常见 Google Play 服务依赖项。您可能还需要将 Firebase 添加到您的项目。

  3. 保存更改并同步项目。

以下代码段展示了一个使用位置信息库的 build.gradle 文件示例:

apply plugin: 'com.android.application'

...

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

我们会定期发布新版 Google Play 服务 SDK,其中包含问题修复和新功能。这些更新会在版本说明中公布。如果您的应用使用的依赖项已更新,请在应用的依赖项中更改为最新版本,以便利用这些修复。

检查是否已安装 Google Play 服务

如 Google Play 服务概览中所述,在搭载 Android 7.0(API 级别 24)及更高版本的设备上,Google Play 服务会通过 Google Play 商店应用自动更新。不过,未安装 Google Play 商店的设备不会安装 Google Play 服务。如果您的应用在没有 Google Play 服务的设备上运行,您应始终在尝试使用 Google API 或启用需要 Google Play 服务的功能之前,检查是否已安装 Google Play 服务。

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

如需开始连接到 Google Play 服务,或了解如何检测已安装的 Google Play 服务版本是否支持特定 API,请参阅访问 Google API 指南。

Google Play 服务依赖项

下表列出了您可以添加到 Android 应用中的 Google Play 服务依赖项。您可以选择其中一个按钮,按设备类型过滤列表;也可以在按钮后面显示的框中输入文本,搜索特定用例或依赖项名称。

表 1. Android 应用中要包含的 Google Play 服务依赖项
用例和依赖项名称 支持的设备
Google 移动广告
com.google.android.gms:play-services-ads:25.5.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:25.0.0
手机、平板电脑
AdSense 搜索广告 (AFS) 自定义搜索广告 (CSA)
com.google.android.gms:play-services-afs-native:19.1.0
手机、平板电脑、ChromeOS
Google Analytics 服务 SDK for Android
com.google.android.gms:play-services-analytics:18.1.1
已弃用。请改用 Google Analytics for Firebase。
App Index
com.google.android.gms:play-services-appindex:16.2.0
手机、平板电脑、Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
手机、平板电脑、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:22.0.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.3.1
手机、平板电脑、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:20.0.0
手机、平板电脑、Auto、Android Go、ChromeOS
实用程序类
com.google.android.gms:play-services-base:18.11.1
手机、平板电脑、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.12.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
相机弱光增强
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09
手机、平板电脑
Google Cast
com.google.android.gms:play-services-cast:22.3.1
手机、平板电脑、Android Go、ChromeOS
Google Cast 应用框架 (CAF)
com.google.android.gms:play-services-cast-framework:22.3.1
手机、平板电脑、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 SDK
com.google.android.gms:contactkeys:16.0.0
手机、平板电脑
线上快速身份验证 (FIDO)
com.google.android.gms:play-services-fido:21.3.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS

在搭载 Android 7.0(API 级别 24)或更高版本的设备上受支持。
Google 健身 API for Android 和移动设备上的 Recording API(用于用户健身数据)
com.google.android.gms:play-services-fitness:21.3.0
手机、平板电脑、Android Go、ChromeOS、Wear OS
Fraud Protect
com.google.android.gms:play-services-fraudprotect:16.0.1
手机、平板电脑、Android Go
Android 版 Google Play 游戏服务 v2
com.google.android.gms:play-services-games-v2:22.1.0
手机、平板电脑、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
Google Play 游戏服务 v1 for Android
com.google.android.gms:play-services-games:25.0.0
已弃用。请改用 Google Play 游戏服务 v2。
Matter API
com.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.4.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
Google Maps SDK for Android
com.google.android.gms:play-services-maps:20.1.0
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
Google Maps 3D SDK for Android
com.google.android.gms:play-services-maps3d:16.0.1
手机、平板电脑
媒体效应增强
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta09
手机、平板电脑
媒体效果录音室音效
com.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02
手机、平板电脑
机器学习套件条形码扫描
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
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
机器学习套件日语文本识别
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.5.1
手机、平板电脑、Android TV、Auto、Android Go
显示开源许可
com.google.android.gms:play-services-oss-licenses:17.5.2
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS
在搭载 Android 5.0(API 级别 21)或更高版本的设备上受支持。
Programmatic Access Library (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 Enterprise for app instrumentation
com.google.android.gms:play-services-recaptcha:17.1.0
手机、平板电脑、Android TV、Android Go、ChromeOS
Remote Gestures API
com.google.android.gms:play-services-remotegestures:16.0.0
手机、平板电脑
安全浏览 v5
com.google.android.gms:play-services-safebrowsing:16.0.0
手机、平板电脑、Android TV、Auto、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 API
com.google.android.gms:play-services-tasks:18.4.1
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS
Acceleration Service for Android
com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02
手机、平板电脑、Android Go、ChromeOS
适用于 Google Play 服务的 TensorFlow Lite GPU 委托 API
com.google.android.gms:play-services-tflite-gpu:16.5.0
手机、平板电脑、Android Go、ChromeOS
适用于 Google Play 服务的 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.5.0
手机、平板电脑、Android Go、ChromeOS
适用于 Google Play 服务的 TensorFlow Lite 支持 API
com.google.android.gms:play-services-tflite-support:16.5.0
手机、平板电脑、Android Go、ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.3.0
手机、平板电脑
Trusted Time API
com.google.android.gms:play-services-time:16.0.1
手机、平板电脑、Auto、Android Go、Wear OS
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
手机、平板电脑、Android Go、ChromeOS
Android 版 Google Pay 支付功能
com.google.android.gms:play-services-wallet:20.0.0
手机、平板电脑、Auto、Android Go、ChromeOS、Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:20.0.1
手机、平板电脑、Wear OS

Gradle 插件

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

表格 2. Google Play 服务中包含的 Gradle 插件列表
应用场景和 Gradle 插件名称 支持的设备
显示开源许可
com.google.android.gms:oss-licenses-plugin:0.13.0
手机、平板电脑、ChromeOS
严格版本检查
com.google.android.gms:strict-version-matcher-plugin:1.2.4
手机、平板电脑、Android TV、Auto、Android Go、ChromeOS、Wear OS