适用于 Android 的使用入门

本指南介绍了如何在 Android 上使用 Google Fit 开始开发。

设置

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

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

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

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

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

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

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

Kotlin DSLGroovy 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.3.0")
}
 
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.3.0'
}

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

构建和测试应用

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

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

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

创建一个 API 客户端，并添加您的应用需要访问才能写入或读取数据的数据类型。可用的端点如下：

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

查看有关如何构建 Fitness API 客户端的示例。

以下是用户在系统请求授予权限时所经历的授权流程：

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

申请验证

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