本指南將逐步引導您建構基本的行動步數計數器應用程式,這是許多健康與健身應用程式的常見基礎。
此工作流程整合了下列 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