Health Connect

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

要求資料類型存取權

為協助強化使用者隱私權和安全性，與 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-alpha11"
}

Kotlin

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

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

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或想提供改善這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.0 版

1.0.0-alpha11 版本

2023 年 2 月 22 日

發布 androidx.health.connect:connect-client:1.0.0-alpha11。1.0.0-alpha11 版包含此連結所列的修訂項目。

API 變更

  • 新增用於開啟 Health Connect 的意圖。(Ic8055)
  • 移除部分運動類型。使用 EXERCISE_TYPE_STRENGTH_TRAINING、EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING 或 EXERCISE_TYPE_CALISTHENICS 取代已移除的類型。(I7291c)
  • 新增 API sdkStatus()，其功能結合了兩個目前已淘汰的 API isSdkSupported() 和 isProviderAvailable()。(Iac89d)
  • 變更接受 providerPackageName 的 API，使其接受單一字串而非清單。(I67e0f)

1.0.0-alpha10 版本

2023 年 1 月 25 日

發布 androidx.health.connect:connect-client:1.0.0-alpha10。1.0.0-alpha10 版包含此連結所列的修訂項目。

API 異動

  • ExerciseEventRecord、ExerciseLapRecord、ExerciseRepititionRecord 和 SwimmingStrokesRecord 已不再是支援的 RecordTypes，無法透過 HealthConnect 寫入或讀取。請從 HealthConnect 整合項目中移除對這些資料類型的參照。(If7ca2)
  • 變更權限 API，接受採用新字串格式的權限。與此同時，您也必須將權限聲明改成標準 Android 權限格式。(Ib0a2f)

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 異動

  • 新增 IntermenstrualBleedingRecord (Idc470)
  • 新增 MenstruationPeriodRecord 記錄類型 (Iea545)

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)。

修正錯誤

  • 不允許 HeartRate beatsPerMinute 值小於 1 (I6052f)
  • 新增 @JvmDefaultWithCompatibility 註解 (I8f206)

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 版包含此連結所列的修訂項目。

修正錯誤

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

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 變得更易於閱讀器讀取，而且不可再為空值。(連結)
  • 新增磅的質量單位 (link)
  • 已將 DeletionChange.deleteUid 重新命名為 uid (連結)
  • 將 Permission 重新命名為 HealthPermission。這可避免 Android 架構權限產生混淆。(連結)

修正錯誤

  • 修正能量卡路里單位不正確的迴歸問題 (連結)
  • 已修正少數記錄類型的匯總迴歸問題 (連結)