本指南會逐步引導您建立基本的行動步數計數器應用程式 是許多健康和動力的共同基礎健身應用程式。
此工作流程整合了下列 API:
- SensorManager,用於從行動裝置擷取步數資料。
- 用於本機資料儲存空間的 Room。
- Health Connect 可在裝置上儲存及分享健康與健身資料。
如需有關資料讀取和必要工具的進一步支援,請參閱「運用方式 使用 Android 感應器管理員,在行動裝置上追蹤步數。
如果您尚未設定使用 Health Connect,請按照下列指示操作 開始使用 100 萬步的訓練
透過手持裝置要求權限
您必須先要求並取得適當的資料,才能取得運動資料 授予其要求的權限。
最佳做法是只要求需要的權限,並確保 在相關情境中要求每項權限,而不是要求所有權限。 授予這項權限。
許多運動應用程式都仰賴的步數計數器感應器
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 層說明文件。
在這個範例應用程式中,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