构建一个基础健身应用

本指南将引导您构建一个基础的移动计步器应用，这是许多健康与健身应用的通用基础。

此工作流程集成了以下 API

  • SensorManager 用于从移动设备检索步数数据。
  • Room 用于本地数据存储。
  • Health Connect 用于在设备上存储和共享健康与健身数据。

有关数据读取和所需工具的更多支持，请参阅使用 Android Sensor Manager 追踪移动设备步数。

如果您尚未设置使用Health Connect 的开发环境，请遵循这些入门步骤。

在手持设备上请求权限

在获取运动数据之前，您必须请求并获得相应的权限。

作为最佳实践，仅请求您需要的权限，并确保在上下文中请求每个权限，而不是在用户启动应用时一次性请求所有权限。

许多运动应用所依赖的步数传感器使用 ACTIVITY_RECOGNITION 权限。将此权限添加到您的 AndroidManifest.xml 文件中

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <uses-permission android:name="android.permission.ACTIVITY_RECOGNITION"/>

</manifest>

要在运行时请求 ACTIVITY_RECOGNITION 权限，请参阅权限请求文档。

您还需要在清单中声明一个 FOREGROUND_SERVICE。由于您正在请求 ACTIVITY_RECOGNITION 权限，请声明 FOREGROUND_SERVICE_TYPE_HEALTH

<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_HEALTH"/>

访问前台服务以了解有关前台服务和前台服务类型的更多信息。

使用 ViewModel 管理界面状态

要正确管理界面状态，请使用 ViewModel。Jetpack Compose 和 ViewModels 提供了对该工作流程更深入的了解。

此外，使用 UI 分层，这是使用 Compose 构建界面的关键部分，它让您可以遵循架构最佳实践，例如单向数据流。要了解有关 UI 分层的更多信息，请参阅UI 层文档。

在此示例应用中，界面有三种基本状态

  • 加载中： 显示一个旋转的圆圈。
  • 内容： 显示您今天的步数信息。
  • 错误： 当出现问题时显示一条消息。

ViewModel 将这些状态公开为 Kotlin Flow。使用密封类来包含表示可能状态的类和对象

class TodayScreenViewModel(...) {

  val currentScreenState: MutableStateFlow<TodayScreenState> = MutableStateFlow(Loading)

  [...]

}

sealed class TodayScreenState {
    data object Loading : TodayScreenState()
    data class Content(val steps: Long, val dailyGoal: Long) : TodayScreenState()
    data object Error: TodayScreenState()
}

Compose UI 然后将此 Flow 收集为 Compose State 并对其进行操作。

val state: TodayScreenState = todayScreenViewModel.currentScreenState.collectAsState().value