健康
下表列出了 androidx.health
组中的所有工件。
工件 | 稳定版 | 候选版本 | Beta 版 | Alpha 版 |
---|---|---|---|---|
health-services-client | - | - | - | 1.0.0-alpha03 |
health-connect-client | - | - | - | 1.0.0-alpha02 |
声明依赖项
如需添加 Health 的依赖项,您必须将 Google Maven 代码库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库。
在应用或模块的 build.gradle
文件中添加所需工件的依赖项:
Groovy
dependencies { implementation "androidx.health:health-services-client:1.0.0-alpha03" // To build applications that can read or write user's health and fitness records. implementation "androidx.health:health-connect-client:1.0.0-alpha02" }
Kotlin
dependencies { implementation("androidx.health:health-services-client:1.0.0-alpha03") // To build applications that can read or write user's health and fitness records. implementation("androidx.health:health-connect-client:1.0.0-alpha02") }
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库的改进有自己的见解,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
Health Connect 客户端版本 1.0
版本 1.0.0-alpha02
2022 年 6 月 1 日
发布了 androidx.health:health-connect-client:1.0.0-alpha02
。版本 1.0.0-alpha02 中包含这些提交。
API 变更
- 废弃了
AggregationResult
中的hasMetric
和getMetric
,添加了包含和获取运算符 (I7cc7c) - 添加
OvulationTest.Result.HIGH
和OvulationTest.Result.INCONCLUSIVE
。(I9f9c4)
bug 修复
- 将 SDK 要求降低到 26。(I6d201)
版本 1.0.0-alpha01
2022 年 5 月 11 日
发布了 androidx.health:health-connect-client:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
新功能
- 提供相关 API,用于读取其他应用分享的健身与健康记录。
- 提供相关 API,用于写入健身和健康记录以便与其他应用共享。
- 提供相关 API,用于检索可访问记录的汇总指标。
- 提供相关 API,用于检索其他应用对记录的增量更改(插入、更新或删除)。
- 提供相关 API,用于提示用户授予健康权限。
- 提供相关 API,用于检查权限或撤消已授予的健康权限。
健康服务客户端版本 1.0
版本 1.0.0-alpha03
2021 年 11 月 3 日
发布了 androidx.health:health-services-client:1.0.0-alpha03
。版本 1.0.0-alpha03 中包含这些提交内容。
新功能
- 如果 IPC 与健康服务 APK 的连接中断,SDK 会自动重新注册测量、运动监听器和被动监控回调注册请求。
API 变更
- SDK 库的 minSdkVersion 已提升为 API 级别 30,因为健康服务客户端目前仅在 Wear3 上受支持。
版本 1.0.0-alpha02
2021 年 9 月 29 日
发布了 androidx.health:health-services-client:1.0.0-alpha02
。版本 1.0.0-alpha02 中包含这些提交。
API 变更
ExerciseClient
现在支持用户提前做好运动准备。这样,客户端就可以在用户开始运动之前,先预热传感器并等待获取 GPS 定位等。- 引入了 CumulativeDataPoints 和 StatisticalDataPoints AggregateDataPoint 类,有助于更好地对在用户运动进行过程中跟踪的汇总指标建模。CumulativeDataPoints 包含汇总的区间数据类型的累计值(例如,运动路线的总距离),而 StatisticalDataPoints 模型会汇总采样数据点数据(例如 HeartRateBpm 最小值、最大值和平均值)。这取代了之前的
AGGREGATE_*
数据类型,并可在 ExerciseUpdate 中通过getLatestAggregateMetrics()
进行访问。AGGREGATE_*
数据类型已不再受支持。 PassiveMonitoring
事件已重命名为PassiveGoals
,后者支持用户制定目标,并在每日指标(即 DAILY_STEPS)等数据类型方面达到这些目标时收到通知。- 引入了新的类,即 HrAccuracy、LocationAccuracy 和 LocationAvailability,改进了心率、位置信息精确度和位置可用性的建模。
- 改进了
ExerciseConfig
和全新PassiveMonitoringConfig
字段的命名方式,并引入了ExerciseConfig.shouldEnableGps
以请求由 GPS 支持的数据
bug 修复
- 迁移到了由 proto 支持的 IPC 传输,以提供更好的向后兼容性支持
版本 1.0.0-alpha01
2021 年 5 月 18 日
发布了 androidx.health:health-services-client:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
初始版本的功能
Health Services 库为开发者提供了一组统一的 API,以便集成设备专用的传感器实现。该库自动支持 Wear OS 3 模拟器和即将推出的设备,未来还会支持更多平台。该初始版本包含三个顶级 API 接口:ExerciseClient
、PassiveMonitoringClient
和 MeasureClient
。
ExerciseClient
ExerciseClient
是专为用于跟踪有效锻炼的应用而设计的,可提供多达 82 种不同的 ExerciseType
,例如步行、跑步、舞蹈和水球等。在跟踪这些锻炼时,有 50 种不同的 DataType
可供选择,具体取决于锻炼类型和设备上可用的硬件。如需开始使用,只需执行以下操作即可:在 ExerciseConfig
中指定相关信息,调用 exerciseClient.startExercise
并通过更新监听器监听进度。
PassiveMonitoringClient
如果您的应用可跟踪用户全天的活动,那么 PassiveMonitoringClient
是一个绝佳选择。您可以使用一组 DataType
注册一个 PendingIntent
,并唤醒此 intent 来处理批量更改。此外,您也可以指定 Event
,例如达到特定步数。
MeasureClient
有时,用户需要衡量当前的指标(例如心率),而不是锻炼时或全天的指标。在这些时候,MeasureClient
是绝佳选择。您只需通过支持的 DataType
注册回调来接收数据流即可;当不再需要回调时,请将其取消注册。