Health Connect

  
允許開發人員讀取或寫入使用者的健康與健身記錄。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2022 年 10 月 24 日 - - - 1.0.0-alpha07

宣告依附元件

如要為 Health 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.0.0-alpha07"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.0.0-alpha07")
}

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。建立新的問題之前,請先查看這個程式庫中的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.0 版本

1.0.0-alpha07 版本

2022 年 10 月 24 日

發布 androidx.health.connect:connect-client:1.0.0-alpha071.0.0-alpha07 版本包含以下修訂項目。

API 變更

  • 沒有預設值的 Record 引數會放在含有預設值的引數之前。為保持一致性,InstantZoneOffset 引數一律會放在最開頭的位置。(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-alpha061.0.0-alpha06 版本包含以下修訂項目。

修正錯誤

  • 改善服務連結生命週期。(If2bd5)
  • 修正在服務連結發生例外狀況時造成的 NPE 當機錯誤。(I13546)

1.0.0-alpha05 版本

2022 年 9 月 21 日

已釋出androidx.health.connect:connect-client:1.0.0-alpha051.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-alpha041.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 架構權限產生混淆。(連結)

修正錯誤

  • 已修正使用 Energy 時錯誤卡路里單位的迴歸問題 (連結)
  • 已修正少數記錄類型的匯總迴歸問題 (連結)