Health Connect
最近更新时间 | 稳定版 | 候选版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2023 年 2 月 22 日 | - | - | - | 1.0.0-alpha11 |
申请对数据类型的访问权限
为了便于我们加强对用户隐私和安全的保护力度,与 Health Connect 集成的开发者必须填写相关开发者声明表单来申请对数据类型的读取和/或写入权限。在该申请中,请根据应用的用途为所需的数据类型添加有效用例。如需了解详情,请参阅 Health Connect 政策要求常见问题解答和 Health Connect by Android 权限。
声明依赖项
如需添加 Health Connect 的依赖项,您必须将 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") }
如需详细了解依赖项,请参阅添加 build 依赖项。
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库有任何改进建议,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
版本 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 的 intent。(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) - 将
HipCircumferenceRecord
、WaistCircumferenceRecord
从受支持的RecordTypes
中移除。(I62fb9) - 将
MenstruationFlowRecord.flow
从stringdef
更改为了intdefs
。(I0369f) - 将包含
Strings
的枚举类记录字段更改为了Integers
,以提升性能。(I3b295) - 将
ExerciseSession
、ExerciseRepetitions
、SleepStage
枚举类字段从字符串类型更改为了整数类型。(Id32a9) - 重命名了
ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL
。(I5d7bd) - 向
CervicalMucus
枚举添加了“Unusual”。将“Clear”重命名为“Eggwhite”,以提高明确性。将CervicalMucus#appearance
和 #sensation 从StringDefs
更改为了 IntDefs。(I3ac51) DeviceTypes
枚举的StringDef
现在已移至“Device”下的IntDefs
。(I3abf3)- 添加了
HealthConnectClient.isApiSupported()
,这会在没有兼容实现的 SDK 版本中返回 false。重命名了HealthConnectClient.isAvailable->isProviderAvailable
。(I3674e)
bug 修复
版本 1.0.0-alpha07
2022 年 10 月 24 日
发布了 androidx.health.connect:connect-client:1.0.0-alpha07
。版本 1.0.0-alpha07 中包含这些提交内容。
API 变更
- 不带默认值的记录参数位于具有默认值的参数之前。为保持一致,
Instant
和ZoneOffset
参数会始终位于最前面。(Id618c) - 已将
HealthConnectClient.getOrCreate#packageNames
重命名为providerPackageNames
。(Id81e4)
bug 修复
- 添加了记录字段值验证。如果提供的值超出合理的范围,则严重错误的值将抛出
IllegalArgumentExceptions
。(Ie171d) - 在相关场景中,验证记录开始时间早于结束时间。(I02460)
版本 1.0.0-alpha06
2022 年 10 月 5 日
发布了 androidx.health.connect:connect-client:1.0.0-alpha06
。版本 1.0.0-alpha06 中包含这些提交内容。
bug 修复
版本 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)
bug 修复
- 修复了不从客户端进程传播前台统计信息的意外行为。(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 变更
- 已将 Metadata
clientId
重命名为clientRecordId
,并将clientVersion
重命名为clientRecordVersion
。(链接) - 使 Metadata uid 更便于读取器读取,今后不可为 null。(链接)
- 向质量单位中添加了磅(链接)
- 已将
DeletionChange.deleteUid
重命名为 uid(链接) - 将 Permission 重命名为 HealthPermission。这避免了与 Android 框架权限混淆。(链接)
bug 修复