本指南将引导您构建一个基本的移动步数统计应用,这是许多健康与健身应用的常见基础。
此工作流集成了以下 API:
- 用于从移动设备检索步数数据的 SensorManager。
- Room,用于本地数据存储。
- 健康数据共享,用于在设备上存储和共享健康与健身数据。
如需获得有关数据读取和必要工具的更多支持,请参阅使用 Android 传感器管理器跟踪移动设备的步数。
如果您尚未设置开发环境以使用健康数据共享,请按照这些入门步骤操作。
在手持设备上请求权限
在获取锻炼数据之前,您必须请求并获得相应的权限。
作为最佳实践,请仅请求您需要的权限,并确保在上下文中请求每项权限,而不是在用户启动应用时一次性请求所有权限。
许多锻炼应用依赖的步数统计传感器使用 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 和 ViewModel 可让您更深入地了解此工作流程。
此外,请使用界面分层,这是使用 Compose 构建界面的关键部分,可让您遵循架构最佳实践,例如单向数据流。如需详细了解界面分层,请参阅界面层文档。
在此示例应用中,界面有三种基本状态:
- 正在加载:显示旋转的圆圈。
- 内容:显示您今天的步数信息。
- 错误:在出现问题时显示消息。
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 界面会收集此 Flow
作为 Compose State
并对其执行操作:
val state: TodayScreenState = todayScreenViewModel.currentScreenState.collectAsState().value