本指南介绍了如何在 Android 设备上使用 Google 健身开始开发。
设置
在开始构建应用之前,请完成以下部分中的步骤。
获取 Google 帐号
若要使用 Google Fit API,您需要拥有 Google 帐号。您可以创建新帐号,也可以使用现有帐号。从用户的角度来看,您可能需要创建一个单独的帐号来测试您的应用。
获取 Google Play 服务
在开发主机上获取最新的 Google Play 服务客户端库:
- 打开 Android SDK 管理器。
- 在 SDK Tools 下,找到 Google Play 服务。
- 如果这些软件包的状态不是 已安装,请同时选中它们,然后点击 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.1.0")
implementation("com.google.android.gms:play-services-auth:20.7.0")
}
Groovy DSL
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-fitness:21.1.0'
implementation 'com.google.android.gms:play-services-auth:20.7.0'
}
这样可以确保 Gradle 在构建您的应用时自动下载健身 SDK。
构建和测试应用
完成设置步骤后,您就可以开始构建应用了。首先,请了解您的应用可以存储和读取的数据类型。详细了解如何在 Google 健身中处理数据。
用户授权流程
下面显示了用户在请求权限时遇到的授权流程:
- Android 权限:用户在下载应用之前,会看到应用请求的 Android 权限。应用下载后,会请求其需要的所有运行时权限,并且用户将授予或拒绝这些权限。
- 检查并连接:您的应用在请求访问其他数据类型之前,会检查其是否已授予权限。
- OAuth 范围请求:Google 会提示用户向应用授予其要访问的数据类型所需的 OAuth 范围。
- 应用访问权限:用户授予权限后,应用可以访问用户已授予权限范围内的数据类型。
申请验证
构建和测试应用后,您需要申请验证,并为敏感范围和受限范围提供不同级别的理由。