迁移指南

Google 产品组合中有许多健康产品和服务,其中包括 Health Connect。Google Fit Android API 已废弃,其支持将持续到 2024 年底,届时该 API 将停用。以下指南介绍应从各 Google Fit Android API 迁移到哪个 API 或平台。

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 并相应插入 ActivitySession 记录或 SleepSession 记录。
  • Recording API

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

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

    手机 Wear

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

    1. 使用 SensorManager 实现数据捕获。
    2. 将捕获的数据写入 Health Connect。
    3. 在前台服务中根据需要合并步骤 a 和步骤 b,例如在需要继续录制数据而不与应用本身交互的情况下。

    使用健康服务

    • 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。

    从 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 集成都保持有效。虽然我们已废弃 Fit Android API,但我们打算在 2024 年底之后再停用该 API。这是为了让用户有充足的时间改用 Health Connect 并继续提供服务。

    第 3 步:清理

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

    1. 移除与 Fit Android API 关联的代码。
    2. 移除依赖项

    您废弃 Fit Android API 的时间应根据您自己的分析和评估而定。与 Fit Android API 的集成可以继续使用到 2024 年底