迁移指南

Google Fit API 将于 2026 年弃用。Google 提供了多款健康和保健产品和服务,可帮助用户在旧版功能弃用后继续实现目标。

以下指南介绍了应迁移到哪个服务,具体取决于您使用 Google Fit Android API 的方式。

我们会使用最新的信息和指南及时更新此页面。

Fit API 集成

如果您使用一个或多个 Fit API,但在界面中添加指向 Fit 应用的直接链接,则需要遵守这些准则。如果您在界面中显示 Google 健身,请参阅 Google 健身应用集成指南

使用 Fit Recording API 记录步数的应用

Fit Recording API 可让应用通过创建订阅,请求以省电的方式自动存储传感器数据。 每项订阅都会将 Android 应用与特定的健身数据类型或数据源相关联,而 Step 数据类型通常用于记录步数。

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

表 1:从 Fit Recording API 迁移的步骤
手机 Wear
  1. 如需继续在应用中显示本地步数数据,请使用移动设备上的 Recording API 实现数据捕获。
  2. 如需显示总步数(包括来自其他应用和设备的汇总步数),请将“健康数据共享”添加到您的应用

使用健康服务:

  • PassiveMonitoringClient
  • ExerciseClient

如需详细了解这两者之间的区别,请参阅健康服务文档

使用 History API 读取或写入健身数据存储区数据的应用

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

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

表 2:从 Fit History API 迁移的步骤
手机 Wear

将健康数据共享添加到您的应用

不适用。通过移动应用(而非穿戴式设备)使用健康数据共享。

使用 Sensor API 显示实时健身数据的应用

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

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

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

表 3:从 Fit Sensor API 迁移的步骤
手机 Wear

使用传感器Fused Location Provider API

在 Wear OS 设备上使用健康服务

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    或者使用 SensorManagerFusedLocationProvider

使用 Session API 提供活动摘要的应用

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

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

请按照以下步骤从 Session API 迁移:

表 4:从 Fit Session API 迁移的步骤
手机 Wear

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

读/写:将健康数据共享添加到您的应用

开始/停止:使用健康服务 (ExerciseClient)

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

关于具体工作流程,我们的建议如下

  • 插入会话:开发者应将 Health Connect 与其移动应用搭配使用,并相应插入 ExerciseSessionRecordSleepSessionRecord

使用 Goals API 的应用

目标是指用户可以在 Google 健身应用中为自己的指标(例如步数和心肺强化分数)设置的目标。Google 健身平台使用 Goals API 记录用户的目标,并对照这些目标跟踪用户每天的活动。

表 5:Fit Goals API 的迁移指南
手机 Wear
没有可用的替代 API。 没有可用的替代 API。

使用 BLE API 的应用

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

请按照以下步骤从 BLE API 迁移

表 6:从 Fit BLE API 迁移的步骤
手机 Wear
直接使用 Android Bluetooth API。 直接使用 Android Bluetooth API。

Fit 应用集成

下文介绍了如何集成 Fit 应用,具体取决于您的应用是已有用户还是新用户。

应用的现有用户

如果您的应用界面包含供用户关联到 Google 健身的方式(或者您的应用包含在支持 Google 健身的应用列表中),您可以继续为现有用户维护 Google 健身应用集成。

我们会及时更新本部分,提供有关何时弃用 Fit 应用集成的信息,以及维护用户体验的最佳方案。在此期间,您可以与我们联系

表 7:针对已集成 Google 健身应用的用户提供的建议
检查执行此操作 关闭不建议的做法
在应用中提供 Health Connect 作为新选项。

侧重于用户福利,例如更丰富的数据和数据分析、隐私保护和安全性。

与健康数据共享同步

要求用户取消与 Google 健身的关联。

解除与“健康数据共享”的关联

应用的新用户

为了向应用的新用户提供类似的体验,我们建议您构建 Health Connect 集成

Health Connect 可让您访问新的数据源和类型,从而为用户提供更丰富的体验。数据存储在设备上,并在用户允许的应用之间安全共享,从而确保数据的私密性和安全性。

表 8:针对新用户(已集成 Fit 应用)的建议
检查执行此操作 关闭不建议的做法
在应用的设置流程中包含 Health Connect。 在健康数据共享可用后,将 Google Fit 作为用户可以关联的应用提供。