适用于 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 服务。
3. 如果这些软件包的状态不是已安装，请同时选择它们 然后点击安装软件包。

获取 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 在 构建应用

构建和测试您的应用

完成设置步骤后，您就可以开始构建应用了。要获得 请先了解您的应用可以存储和访问的数据类型 read。详细了解如何 数据。

获取必要的 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. 已应用访问权限：用户授予权限后，您的应用可以 访问属于用户已授权范围的数据类型 权限。

申请验证

构建并测试应用之后，您需要申请 使用不同的 Google 方法进行验证， 提出多个合理的理由， 敏感范围和受限范围。