迁移指南

Google Fit API 将于 2026 年弃用。Google 提供多种健康和健身产品及服务,以帮助您的用户在弃用后继续实现其目标。

以下指南将根据您使用 Google Fit Android API 的方式,向您展示应迁移到哪个服务。

我们将持续更新此页面,提供最新信息和指南。

Fit API 集成

如果您使用一个或多个 Fit API,但在您的界面中包含指向 Fit 应用的直接链接,则这些指南适用于您。如果您在界面中显示 Fit,请参阅Fit 应用集成指南

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

Fit Recording API 允许您的应用通过创建订阅,以省电的方式请求自动存储传感器数据。每个订阅将 Android 应用连接到特定的健身数据类型或数据源,而 Step 数据类型常用于记录步数。

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

手机 可穿戴设备
  1. 要继续在您的应用中显示本地步数数据,请使用移动设备上的 Recording API 实现数据捕获。
  2. 要显示总步数,包括来自其他应用和设备的聚合步数系统,请将 Health Connect 添加到您的应用

使用 Health Services

  • PassiveMonitoringClient
  • ExerciseClient

有关两者之间差异的更多信息,请参阅 Health Services 文档

使用 History API 读写健身数据存储的应用

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

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

手机 可穿戴设备

将 Health Connect 添加到您的应用.

不适用。请使用您的移动应用而非可穿戴设备上的 Health Connect。

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

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

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

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

手机 可穿戴设备

使用 SensorsFused Location Provider API

在 Wear OS 上使用 Health Services

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    或者使用 SensorManagerFusedLocationProvider

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

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

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

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

手机 可穿戴设备

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

读/写:将 Health Connect 添加到您的应用

开始/停止:使用 Health Services (ExerciseClient)

读/写:使用您的移动应用上的 Health Connect。

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

  • 插入会话:开发者应使用其移动应用上的 Health Connect,并相应地插入 ExerciseSessionRecordSleepSessionRecord

使用 Goals API 的应用

目标是 Google Fit 应用中用户可以为步数和心点等指标设置的目标。Fit 平台使用 Goals API 记录这些目标并跟踪其日常活动。

手机 可穿戴设备
没有可用的替代 API。 没有可用的替代 API。

使用 BLE API 的应用

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

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

手机 可穿戴设备
直接使用 Android 蓝牙 API。 直接使用 Android 蓝牙 API。

Fit 应用集成

以下介绍如何根据您应用现有用户或新用户的情况来集成您的 Fit 应用。

您的应用现有用户

如果您的应用界面包含让用户连接到 Google Fit 的方式(或如果您的应用包含在支持 Google Fit 的应用列表中),您可以继续为现有用户维护您的 Fit 应用集成。

我们将持续更新此部分,提供何时弃用您的 Fit 应用集成以及维护用户体验的最佳选择。同时,您可以联系我们

check这样做 close不要这样做
在您的应用中提供 Health Connect 作为新选项。

关注用户利益,例如更丰富的数据和洞察、隐私和安全。

Sync with Health Connect

要求用户断开与 Google Fit 的连接。

Disconnect from Health Connect

您的应用新用户

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

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

check这样做 close不要这样做
在您应用的设置流程中包含 Health Connect。 在 Health Connect 可用后,将 Fit 作为用户可以连接的应用提供。