迁移指南

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 或平台

手机 Wear

使用 SensorManager、FusedLocationProvider

使用健康服务

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    或使用 SensorManager、FusedLocationProvider

会话 API

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

会话 API 使您的应用能够在健身存储中创建会话。

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

手机 Wear

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

读取/写入:使用 Health Connect。

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

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

对于特定工作流程,建议执行以下操作

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

录制 API

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

从录音 API 迁移到以下 API 或平台

手机 Wear

请按照以下步骤从录音 API 迁移

  1. 使用 移动设备上的录音 API 实现数据采集。
  2. 将采集到的数据写入 Health Connect 或您的应用程序数据库。

使用健康服务

  • PassiveMonitoringClient
  • ExerciseClient

查看 Health Services 文档,了解 PassiveMonitoringClient 和 ExerciseClient 之间的更多区别。

历史记录 API

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

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

手机 Wear

使用 Health Connect

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

目标 API

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

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

BLE API

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

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

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