迁移指南

Google 的产品组合中包含许多健康产品和服务,包括 Health Connect。Google Fit API 已弃用,并将支持到 **2025 年 6 月 30 日**,届时将停止服务。以下指南显示了从每个 Google Fit Android API 迁移到哪个 API 或平台。

从 Fit Android API 迁移到 Health Connect API

迁移到 Health Connect API 需要经历 **3** 个关键步骤。

步骤 1:集成

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

  • 按照这些 入门步骤 集成 Health Connect。
  • 在应用清单中声明应用所需的数据类型和访问模式。
  • 获得用户的许可以访问 Health Connect。
  • 根据您的特定用例或工作流程读取/写入数据。

步骤 2:迁移

我们建议在用户从一个平台迁移到另一个平台的同时,保持 Google Fit Android API 和 Health Connect API 集成处于活动状态。虽然我们已弃用 Google Fit Android API,但我们的目标是将 API 的停止时间推迟到 **2025 年 6 月 30 日** 之后。这是为了给用户足够的时间切换到 Health Connect 并继续使用其服务。

步骤 3:清理

按照以下步骤删除 Google Fit SDK:

  1. 删除与 Google Fit Android API 相关的代码。
  2. 删除 Google Play 服务 依赖项

传感器 API

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

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

从传感器 API 迁移到以下 API 或平台:

手机 手表

使用 SensorManager、FusedLocationProvider

使用健康服务

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    或使用 SensorManager、FusedLocationProvider

会话 API

会话代表用户执行健身活动的时间间隔。

会话 API 允许您的应用在健身存储区中创建会话。

从会话 API 迁移到以下 API 或平台:

手机 手表

启动/停止:不适用。应用程序应在内部跟踪正在进行的会话的状态。

读取/写入:使用 Health Connect。

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

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

对于特定工作流程,我们建议如下:

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

Recording API

Recording API 允许您的应用通过创建订阅以节能的方式请求自动存储传感器数据。订阅与 Android 应用相关联,并包含健身数据类型或特定数据源。

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

手机 手表

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

  1. 使用移动端的录制 API实现数据捕获。
  2. 将捕获的数据写入 Health Connect 或您的应用数据库。

使用健康服务

  • PassiveMonitoringClient
  • ExerciseClient

有关 `PassiveMonitoringClient` 和 `ExerciseClient` 之间差异的更多信息,请参阅 Health 服务文档

历史记录 API

历史记录 API 允许您的应用对健身存储执行批量操作,包括读取、插入、更新和删除历史健康和保健数据。

从历史记录 API 迁移到以下 API 或平台

手机 手表

使用 Health Connect

从移动应用而不是可穿戴设备使用 Health Connect。

目标 API

目标是在 Google Fit 应用中用户可以为自己设定的目标。它们有助于激励用户每天保持活跃。用户可以在其个人资料中调整他们每天想要达到的步数和心率点数。Fit 平台使用目标 API记录他们的目标并跟踪其每日活动。

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

BLE API

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

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

手机 手表
直接使用 Android 蓝牙 API。 直接使用 Android 蓝牙 API。