Health Connect
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2024 年 1 月 10 日 | - | - | - | 1.1.0-alpha07 |
要求資料類型存取權
為協助強化使用者隱私權和安全性,與 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.1.0-alpha07" }
Kotlin
dependencies { // Use to implement health connects implementation("androidx.health.connect:connect-client:1.1.0-alpha07") }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 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 變更
修正錯誤
- 在繫結失敗時擲回
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)。 - 讓
HealthPermissionsRequestContract#createIntent
檢查所有 Android 版本。合約會檢查所有權限是否為健康相關權限。(I143fc)。
修正錯誤
- 修正使用包含空白位置清單的
ExerciseRoute
建立ExerciseSessionRecord
時,系統擲回的例外狀況。(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)。 - 已新增
ExerciseRouteRequestContract
,已新增HealthPermissionsRequestContract
。(Ief0e5)。
修正錯誤
- 修正千焦耳的能源建構問題 (Ie8791)
1.1.0-alpha02 版
2023 年 6 月 21 日
發布 androidx.health.connect:connect-client:1.1.0-alpha02
。1.1.0-alpha02 版本包含以下修訂項目。
修正錯誤
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()
,其功能結合了兩個目前已淘汰的 APIisSdkSupported()
和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 變更
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 變得更易於閱讀器讀取,而且不可再為空值。(連結)
- 將磅秤加重至質量單位 (連結)
- 已將
DeletionChange.deleteUid
重新命名為 uid (連結) - 將 Permission 重新命名為 HealthPermission。這可避免 Android 架構權限產生混淆。(連結)
修正錯誤