适用于 Android 的使用入门

本指南介绍如何开始在 Android 上使用 Google 健身进行开发。

注意 ：Google 健身是 Google Play 服务的一部分。了解您的应用使用 Google Play 服务的优势。

设置

在开始构建应用之前，请完成以下部分中的步骤。

获取 Google 账号

您需要拥有 Google 帐号才能使用 Google Fit API。您可以创建新帐号，也可以使用现有帐号。您可能需要创建单独的帐号来从用户的角度测试应用。

获取 Google Play 服务

在开发主机上获取适用于 Google Play 服务的最新客户端库：

1. 打开 Android SDK 管理器。
2. 在 SDK Tools 下，找到 Google Play services。
3. 如果这些软件包的状态不是“已安装”，请同时选择这两个软件包，然后点击 Install Packages（安装软件包）。

获取 OAuth 2.0 客户端 ID

如需启用 Fitness API，请获取 OAuth 2.0 客户端 ID。

创建和配置项目

我们建议使用 Android Studio 开发环境构建包含 Fitness API 的应用。如需详细了解如何在 Android Studio 中创建新项目并对其进行配置，请参阅创建项目。

添加 Google Play 服务客户端库

在 Android Studio 中，打开模块的 build.gradle 文件，并将 Google Play 服务客户端库添加为依赖项：

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

时髦 DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.2.0'
}

这样可以确保 Gradle 在构建应用时自动下载健身 SDK。

构建和测试您的应用

完成设置步骤后，您就可以开始构建应用了。为此，请先了解您的应用可以存储和读取的数据类型。详细了解如何在 Google 健身中使用数据。

获取必要的 Android 权限

如需读取和写入某些类型的数据，您的应用需要请求 Android 权限。

获取 OAuth 权限

您的应用有权访问的数据类型与授权范围相对应。如需请求这些权限，您需要在 FitnessOptions 实例中添加应用需要访问的数据类型。当您的应用请求使用任何 Google 健身数据类型时，Android SDK 会自动检查它们所属的范围，并要求用户提供这些范围的授权。

创建 API 客户端

创建 API 客户端并添加应用写入或读取数据所需的数据类型。您可以使用以下端点：

• SensorsClient：通过本地设备和配套设备上的硬件传感器访问不同来源的健康和健身数据。
• RecordingClient：适用于始终开启的低功耗后台传感器数据收集。
• HistoryClient：在 Google 健身中插入、删除和读取历史数据。
• SessionsClient：创建和管理用户活动的会话。
• GoalsClient：读取用户在 Google 健身中创建的“心肺强化分数”和“步数”目标。
• ConfigClient：访问 Google 健身平台中的自定义数据类型和设置。

查看构建 Fitness API 客户端的示例。

产生的用户授权流程

下面显示了用户在请求权限时所经历的授权流程：

图 1. 用户的授权流程。

1. Android 权限：用户在下载您的应用之前，可以看到应用请求了哪些 Android 权限。下载应用后，应用会请求所需的任何运行时权限，然后用户可授予或拒绝这些权限。
2. 检查并连接：应用在请求访问其他数据类型之前，会检查用户是否已授予权限。
3. OAuth 范围请求：Google 会提示用户向应用授予其想要访问的数据类型所需的 OAuth 范围。
4. 已应用访问权限：用户授予权限后，您的应用可以访问属于用户已授予权限的范围的数据类型。

申请验证

构建并测试应用后，您需要申请验证，并提供敏感范围和受限范围所需的不同理由级别。