本指南介绍如何开始在 Android 上使用 Google 健身进行开发。
设置
在开始构建应用之前,请完成以下部分中的步骤。
获取 Google 账号
您需要拥有 Google 帐号才能使用 Google Fit API。您可以创建新帐号,也可以使用现有帐号。您可能需要创建单独的帐号来从用户的角度测试应用。
获取 Google Play 服务
在开发主机上获取适用于 Google Play 服务的最新客户端库:
- 打开 Android SDK 管理器。
- 在 SDK Tools 下,找到 Google Play services。
- 如果这些软件包的状态不是“已安装”,请同时选择这两个软件包,然后点击 Install Packages(安装软件包)。
添加 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 范围请求:Google 会提示用户向应用授予其想要访问的数据类型所需的 OAuth 范围。
- 已应用访问权限:用户授予权限后,您的应用可以访问属于用户已授予权限的范围的数据类型。
申请验证
构建并测试应用后,您需要申请验证,并提供敏感范围和受限范围所需的不同理由级别。