Health Connect
| 最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
|---|---|---|---|---|
| 2023 年 1 月 11 日 | - | - | - | 1.0.0-alpha09 |
要求資料類型存取權
為協助強化使用者隱私權和安全性，與 Health Connect 整合的開發人員必須填寫下方的開發人員聲明表單，要求讀取和/或寫入資料類型。在要求中，請根據應用程式的用途，為所需資料類型加入有效的用途。詳情請瀏覽 Health Connect 政策規定常見問題和 Health Connect by Android 權限。
宣告依附元件
如要為 Health 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。
在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：
Groovy
dependencies {
// Use to implement health connects
implementation "androidx.health.connect:connect-client:1.0.0-alpha09"
}
Kotlin
dependencies {
// Use to implement health connects
implementation("androidx.health.connect:connect-client:1.0.0-alpha09")
}
如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。發現新問題或想針對這個程式庫提出改進建議時，請告訴我們。建立新問題前，請先查看這個程式庫中的現有問題。只要按一下星號按鈕，即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
1.0 版本
1.0.0-alpha09 版本
2023 年 1 月 11 日
發布 androidx.health.connect:connect-client:1.0.0-alpha09。1.0.0-alpha09 版包含以下修訂項目。
新功能
- 為 Health Connect 新增 2 種新的女性健康資料類型：
IntermenstrualBleedingRecord和MenstruationPeriodRecord。MenstruationFlow.ENUMs包括少量、中量、大量和不明。
API 異動
1.0.0-alpha08 版本
2022 年 12 月 7 日
發布了 androidx.health.connect:connect-client:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂版本。
API 變更
- 將
BodyWaterMass、HeartRateVariabilityRmssdRecord新增為支援的記錄類型 (Ifd58f)。 - 從支援的
RecordTypes中移除HipCircumferenceRecord、WaistCircumferenceRecord(I62fb9)。 MenstruationFlowRecord.flow已從stringdef變更為intdefs(I0369f)。- 為提升效能，含有
Strings的列舉類記錄欄位已變更為Integers(I3b295)。 ExerciseSession、ExerciseRepetitions和SleepStage列舉類欄位已從字串變更為整數類型 (Id32a9)。ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL已重新命名 (I5d7bd)。- 將「Unusual」新增至
CervicalMucus列舉。為提供更具體的資訊，我們將「Clear」重新命名為「Eggwhite」。此外，CervicalMucus#appearance和 #sensation 已從StringDefs變更為 IntDefs (I3ac51)。 DeviceTypes列舉的StringDef現已移至「裝置」底下的IntDefs(I3abf3)。- 新增
HealthConnectClient.isApiSupported()，這會在沒有相容導入方式的 SDK 版本中傳回 false。HealthConnectClient.isAvailable->isProviderAvailable也已重新命名 (I3674e)。
修正錯誤
1.0.0-alpha07 版本
2022 年 10 月 24 日
發布 androidx.health.connect:connect-client:1.0.0-alpha07。1.0.0-alpha07 版包含以下修訂項目。
API 變更
- 沒有預設值的 Record 引數會放在含有預設值的引數之前。為保持一致性，
Instant和ZoneOffset引數一律會放在最開頭的位置。(Id618c) - 將
HealthConnectClient.getOrCreate#packageNames重新命名為providerPackageNames。(Id81e4)
修正錯誤
- 新增 Record 欄位值驗證功能。如果提供的值超出合理範圍，將導致極端錯誤值擲回
IllegalArgumentExceptions。(Ie171d) - 在相關結束時間之前，驗證記錄開始時間。(I02460)
1.0.0-alpha06 版本
2022 年 10 月 5 日
發布 androidx.health.connect:connect-client:1.0.0-alpha06。1.0.0-alpha06 版本包含以下修訂項目。
修正錯誤
1.0.0-alpha05 版本
2022 年 9 月 21 日
已釋出androidx.health.connect:connect-client:1.0.0-alpha05。1.0.0-alpha05 版包含以下修訂項目。
API 變更
- 已重新命名
Metadata.uid->Metadata.id，且在相關的 CRUD API 中一律使用「recordId」術語。(I3d1d2) - 將
PermissionController.createRequestPermissionActivityContract設為靜態方法，而非執行個體方法。已重新命名為PermissionController.createRequestPermissionResultContract(Icd2fe) - 已為
BloodGlucoseRecord新增BloodGlucose單位類型。(I97678) - 重新命名
MenstruationRecord->MenstruationFlowRecord(I3b88e)
修正錯誤
- 修正不會從用戶端程序傳播前景統計資料的意外行為。(Ifb44c)
1.0.0-alpha04 版本
2022 年 8 月 24 日發布 androidx.health.connect:connect-client:1.0.0-alpha04。1.0.0-alpha04 版本包含以下修訂項目。
遷移至 androidx.health.connect
自 1.0.0-alpha04 版本起，androidx.health:health-connect-client 已遷移至 androidx.health.connect:connect-client。如需舊版的 Health Connect，請前往 androidx.health 頁面。
如要遷移，只需將依附元件匯入內容從 androidx.health:health-connect-client:1.0.0-alpha03 變更為 androidx.health.connect:connect-client:1.0.0-alpha04 即可。
新功能
- 針對 API 呼叫內建選用的偵錯記錄檔 (連結)
API 變更
- 將中繼資料
clientId重新命名為clientRecordId，並將clientVersion重新命名為clientRecordVersion。(連結) - 為讀者提供更友善易用的中繼資料 uid，此 uid 不可再設為空值。(連結)
- 新增磅為「質量」單位 (link)
- 已將
DeletionChange.deleteUid重新命名為 uid (連結) - 將 Permission 重新命名為 HealthPermission。這可避免 Android 架構權限產生混淆。(連結)
修正錯誤