本指南將逐步引導您建構基本的行動步數計數器應用程式，這是許多健康與健身應用程式的常見基礎。
此工作流程整合了下列 API：
- SensorManager，用於從行動裝置擷取步數資料。
- 本機資料儲存空間的空間。
- Health Connect：儲存及分享裝置上的健康與健身資料。
如需其他資料讀取和必要工具的支援功能，請參閱「使用 Android 感應器管理員追蹤行動裝置上的步驟」。
如果您尚未設定使用 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 管理 UI 狀態
如要妥善管理 UI 狀態，請使用 ViewModel。Jetpack Compose 和 ViewModel 可讓您更深入瞭解這項工作流程。
此外，請使用 UI 分層，這是使用 Compose 建構使用者介面的重要部分，並可讓您遵循架構最佳做法，例如單向資料流。如要進一步瞭解 UI 分層，請參閱 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 會以 Compose State 的形式收集這個 Flow，並對其執行動作：
val state: TodayScreenState = todayScreenViewModel.currentScreenState.collectAsState().value