如何在Flutter移动应用中集成Android HealthConnect？

针对你要从HealthConnect读取三星健康中心率、SPo2、血压等体征数据到Flutter应用的需求，以下是可行的实现方案，结合你提到的flutter_health_connect包展开：

核心逻辑 #

Android HealthConnect作为跨应用健康数据的中间层，会同步三星健康等应用的体征数据；Flutter通过flutter_health_connect插件调用HealthConnect的系统API，完成权限申请、数据读取操作。

具体实现步骤 #

1. 配置Android端基础环境 #

• 确保Flutter项目的Android目标SDK版本≥33（HealthConnect要求Android 13+）
• 在android/app/src/main/AndroidManifest.xml中声明所需权限：

<uses-permission android:name="android.permission.health.READ_HEART_RATE" />
<uses-permission android:name="android.permission.health.READ_BLOOD_PRESSURE" />
<uses-permission android:name="android.permission.health.READ_SPO2" />

同时添加HealthConnect的meta-data声明：

<meta-data
    android:name="android.health.connect.health_permissions"
    android:resource="@xml/health_connect_permissions" />

在android/app/src/main/res/xml目录下创建health_connect_permissions.xml，定义权限组：

<?xml version="1.0" encoding="utf-8"?>
<permissions>
    <permission android:name="android.permission.health.READ_HEART_RATE" />
    <permission android:name="android.permission.health.READ_BLOOD_PRESSURE" />
    <permission android:name="android.permission.health.READ_SPO2" />
</permissions>

2. 初始化插件并检查HealthConnect可用性 #

在Flutter代码中先验证设备是否支持HealthConnect：

import 'package:flutter_health_connect/flutter_health_connect.dart';

Future<void> checkHealthConnectStatus() async {
  final isAvailable = await FlutterHealthConnect.isHealthConnectAvailable();
  if (!isAvailable) {
    // 提示用户安装或启用HealthConnect应用
    await FlutterHealthConnect.requestInstallHealthConnect();
  }
}

3. 请求读取权限 #

必须在运行时向用户申请对应的数据读取权限：

Future<void> requestHealthPermissions() async {
  final permissions = [
    HealthPermission.read(HealthDataType.heartRate),
    HealthPermission.read(HealthDataType.bloodPressure),
    HealthPermission.read(HealthDataType.spO2),
  ];

  final result = await FlutterHealthConnect.requestPermissions(permissions);
  if (!result.allGranted) {
    // 处理权限拒绝场景，比如引导用户到设置页开启权限
  }
}

4. 读取健康数据 #

以读取近7天的心率数据为例：

Future<List<HeartRateRecord>> fetchHeartRateHistory() async {
  final startDate = DateTime.now().subtract(const Duration(days: 7));
  final endDate = DateTime.now();

  final records = await FlutterHealthConnect.getRecords(
    HealthDataType.heartRate,
    startDate: startDate,
    endDate: endDate,
  );

  return records.cast<HeartRateRecord>();
}

读取血压、SPo2数据的逻辑类似，只需替换对应的HealthDataType为bloodPressure或spO2，并转换为对应的Record类型即可。

关键注意事项 #

• 三星健康数据同步：需用户在三星健康设置中，授权HealthConnect访问对应的数据类型，否则HealthConnect中不会同步三星健康的数据。
• 设备兼容性：仅Android 13及以上系统支持HealthConnect，需提前做兼容性判断并给用户明确提示。
• 数据字段解析：不同类型的Record包含专属字段，比如血压包含收缩压、舒张压数值，心率包含即时心率值，需根据业务需求提取对应字段展示。

内容的提问来源于stack exchange，提问作者Kishore Sathiyaraj