本頁面由 Cloud Translation API 翻譯而成。

Health Connect

允許開發人員讀取或寫入使用者的健康與健身記錄。

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2024 年 1 月 10 日	-	-	-	1.1.0-alpha07

要求資料類型存取權

為協助強化使用者隱私權和安全性，與 Health Connect 整合的開發人員必須針對應用程式所使用的資料類型，宣告讀取和/或寫入存取權。開發人員必須根據應用程式的用途，為所用資料類型加入有效的用途。詳情請參閱「提供健康應用程式聲明表單的相關資訊」和「Health Connect by Android 權限」。

宣告依附元件

如要新增健康狀態的依附元件，必須將 Google Maven 存放區新增至您的專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

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

意見回饋

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

建立新問題

詳情請參閱 Issue Tracker 文件。

1.1 版本

1.1.0-alpha07 版本

2024 年 1 月 10 日

發布 androidx.health.connect:connect-client:1.1.0-alpha07。查看 1.1.0-alpha07 版的修訂項。

API 變更

從設定檔使用者結構定義呼叫 #getSdkStatus 時，傳回 SDK_UNAVAILABLE。(I91df3)。
移除 SleepStageRecord。(/If6ada)。

修正錯誤

如果繫結失敗，請擲回 RemoteException，而非 IllegalStateException。(Id2233)。

1.1.0-alpha06 版本

2023 年 10 月 18 日

發布 androidx.health.connect:connect-client:1.1.0-alpha06。查看 1.1.0-alpha06 版的修訂項。

API 變更

將 recordingMethod 定義設為公開。(I401fb)。

修正錯誤

將說明文件新增至運動路線，指定該位置應在時段結束時間之前。(0e51e6)。

1.1.0-alpha05 版本

2023 年 10 月 4 日

發布 androidx.health.connect:connect-client:1.1.0-alpha05。查看 1.1.0-alpha05 版的修訂項。

API 變更

新增意圖，以便前往 Health Connect 資料管理畫面。(Ibf591)。
已移除 AggregationResult 中已淘汰的方法。(Idbda9)。
新增了便利的 API，可用於建立 ReadRecordsRequest，以及刪除和讀取記錄類型的相關記錄。(If58a5)。

修正錯誤

已修正 Android 14 中以 Double.MIN_VALUE 形式傳回空值營養欄位的錯誤。(1aa1d1)。
已修正 Android 14 中，由於值區的開始/結束時間相同，依據每月/每年週期匯總在回應中擲回例外狀況的錯誤。(281313)。

1.1.0-alpha04 版本

2023 年 9 月 6 日

發布 androidx.health.connect:connect-client:1.1.0-alpha04。查看 1.1.0-alpha04 版的修訂項。

API 變更

僅限 Java：將 ChangesResponse 中的 getHasMore() 欄位重新命名為 hasMore()。(I80695)。
在各 Android 版本之間保持一致 HealthPermissionsRequestContract#createIntent。合約會確認所有權限都是健康相關權限。(I143fc)。

修正錯誤

修正在建立 ExerciseSessionRecord 和含有空白位置清單的 ExerciseRoute 時，系統擲回的例外狀況。(I45c16)。
更新 SleepSessionRecord 說明文件和程式碼範例，瞭解如何讀取睡眠時段。(Idf0de)。

1.1.0-alpha03 版本

2023 年 7 月 26 日

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

新功能

用於讀取及寫入運動路線的 API：
- 已將「ExerciseRouteResult」新增至「ExerciseSessionRecord」
- 已新增「ExerciseRouteRequestContract」

API 變更

新增了 ExerciseRouteResult 及其子類別：Data、NoData 和 ConsentRequiredStates。
將 ExerciseRoute 新增為獨立類別，用於保留路線的位置資料。(I22eed)。
新增了 PERMISSION_WRITE_EXERCISE_ROUTE。(I92fc4)。
新增了 HealthPermissionsRequestContract，ExerciseRouteRequestContract。(Ief0e5)。

修正錯誤

固定熱量以千焦耳 (Ie8791)

1.1.0-alpha02 版本

2023 年 6 月 21 日

發布 androidx.health.connect:connect-client:1.1.0-alpha02。1.1.0-alpha02 版本包含以下修訂項目。

修正錯誤

修正 HealthDataSdkService 外洩的問題 (Ia3ba5)
在 Android U 上要求權限時，一律重新導向至正確的 HealthConnect 用戶端 (I6415a)。

1.1.0-alpha01 版本

2023 年 6 月 7 日

發布 androidx.health.connect:connect-client:1.1.0-alpha01。這個版本是在內部分支版本中開發。

新功能

支援 Android 14 架構版本的 Health Connect。此 SDK 是 Android 14 的先決條件。如未開啟這個應用程式，應用程式就無法在 Android 14 中整合 Health Connect。
在記錄中繼資料中新增錄製方法。

API 變更

工作階段 API 變更：
- 已將多個睡眠階段新增至 SleepSessionRecord，並移除 SleepStageRecord。
- 已將 ExerciseLap 和 ExerciseSegment 新增至 ExerciseSessionRecord。
讀取、變更記錄、插入及刪除作業的定期和每日頻率限制 (包括記憶體限制)。
已為所有 NutritionRecord 欄位新增驗證作業。
已新增 HeartRateVariabilityRmssdRecord 的驗證。
已移除兩個已淘汰的 API：HealthConnectClient#isProviderAvailable 和 HealthConnectClient#isApiSupported。

修正錯誤

所有單位類型的固定單位等式，相等不再取決於用於單位初始化的型別。例如：Mass.grams(1000) 現在等於 Mass.kilograms(1)。

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)。
新增「異常」至 CervicalMucus 列舉。重新命名「清除」「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 連線，請造訪 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 (連結)
重新命名權限 ->健康權限。這可避免 Android 架構權限產生混淆。(連結)

修正錯誤

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