迁移指南

Google 产品组合中有许多健康产品和服务,其中包括 Health Connect。我们已弃用 Google Fit API,并会在 2025 年 6 月 30 日之前停止使用这些 API。以下指南介绍应从各 Google Fit Android API 迁移到哪个 API 或平台。

从 Fit Android API 迁移到 Health Connect API

迁移到 Health Connect API 需要完成 3 个主要步骤。

第 1 步:集成

第一步的集成是将 Health Connect 添加到您的应用中。这一步包括以下操作:

  • 按照这些开始使用步骤与 Health Connect 集成。
  • 在应用清单中声明所需的数据类型和访问模式。
  • 向用户请求访问 Health Connect 的权限。
  • 根据具体的用例或工作流读/写数据。

第 2 步:迁移

当用户在 Google 健身和 Health Connect 这两个平台间迁移时,建议让 Google Fit Android API 集成和 Health Connect API 集成都保持有效。虽然我们已弃用 Google Fit Android API,但计划最晚于 2025 年 6 月 30 日停用该 API。这是为了让用户有充足的时间改用 Health Connect 并继续提供服务。

第 3 步:清理

请按照以下步骤移除 Google 健身 SDK:

  1. 移除与 Google 健身 Android API 关联的代码。
  2. 移除 Google Play 服务依赖项

Sensor API

Sensor API 可用于在应用中实时读取原始传感器数据。Sensor API 执行以下操作:

  • 列出设备和配套设备上可用的数据源。
  • 注册用于接收原始传感器数据的监听器。
  • 取消注册监听器,使其不再接收原始传感器数据。

请从 Sensor API 迁移到以下 API 或平台

手机 Wear

使用 SensorManager、FusedLocationProvider

使用健康服务

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    或者使用 SensorManager、FusedLocationProvider

Session API

会话表示用户进行某项健身活动的时间间隔。

Session API 可让应用在健身数据存储区中创建会话。

请从 Session API 迁移到以下 API 或平台

手机 Wear

开始/停止:不适用。应用应在内部跟踪正在进行的会话的状态。

读/写:使用 Health Connect。

启动/停止:使用健康服务 (ExerciseClient)

读/写:通过移动应用使用 Health Connect。

对于具体的工作流程,我们建议

  • 插入时段:开发者应通过移动应用使用 Health Connect,并相应地插入 ExerciseSession 记录或 SleepSession 记录。

Recording API

Recording API 可让应用通过创建订阅,请求以省电的方式自动存储传感器数据。订阅与 Android 应用相关联,包含一个健身数据类型或一个特定的数据源。

请从 Recording API 迁移到以下 API 或平台

手机 Wear

请按以下步骤从 Recording API 迁移:

  1. 使用 Recording API 在移动设备上实现数据捕获功能。
  2. 将捕获的数据写入 Health Connect 或您的应用数据库。

使用健康服务

  • PassiveMonitoringClient
  • ExerciseClient

如需详细了解 PassiveMonitoringClient 和 ExerciseClient 之间的区别,请参阅健康服务文档

History API

History API 可让应用对健身数据存储区执行批量操作,包括读取、插入、更新和删除身心健康方面的历史数据。

请从 History API 迁移到以下 API 或平台

手机 Wear

使用 Health Connect

通过移动应用(而非穿戴式设备)使用 Health Connect。

Goals API

目标是指用户可以在 Google 健身应用中为自己设置的目标。目标可以激励用户每天保持活力。用户可以在个人资料中调整每天希望达到的步数和心肺强化分数目标。Google 健身平台使用 Goals API 记录用户的目标,并对照这些目标跟踪用户每天的活动。

手机 Wear
没有可用的替代 API。 没有可用的替代 API。

BLE API

应用可以使用 BLE API 查找可用的蓝牙低功耗 (BLE) 设备,并将传感器数据插入 Google 健身平台中。

请从 BLE API 迁移到以下 API 或平台

手机 Wear
直接使用 Android Bluetooth API。 直接使用 Android Bluetooth API。