如何为@kingstinct/react-native-healthkit原生添加训练子活动/事件功能？

要实现Apple Health中类似铁人三项的分段训练记录，需要修改该包的iOS原生代码、RN桥接层并扩展API，具体步骤如下：

1. 修改iOS原生模块 #

该包的HealthKit交互逻辑在ios目录下的原生文件（通常是RNHealthKit.m/RNHealthKit.swift）中：

• 找到创建HKWorkout对象的代码块，原逻辑仅处理主训练活动，需添加workoutSegments属性支持
• 扩展参数接收逻辑，从RN端传入的训练数据中解析子活动分段信息（含每个分段的活动类型、开始/结束时间）
• 将分段数据转换为HKWorkoutSegment数组，示例Objective-C代码：

  HKWorkoutActivityType segmentType = HKWorkoutActivityTypeSwimming;
  NSDate *segmentStart = [NSDate dateWithTimeIntervalSince1970:segmentData[@"startDate"]];
  NSDate *segmentEnd = [NSDate dateWithTimeIntervalSince1970:segmentData[@"endDate"]];
  HKWorkoutSegment *segment = [HKWorkoutSegment workoutSegmentWithActivityType:segmentType startDate:segmentStart endDate:segmentEnd];
  

• 将生成的分段数组赋值给HKWorkout的workoutSegments属性，再写入HealthKit

2. 更新RN桥接层与类型定义 #

• 在包的TypeScript定义文件（如index.d.ts）中添加子活动类型：

  export interface WorkoutSegment {
    activityType: ActivityType; // 复用现有活动类型枚举
    startDate: number; // 时间戳格式
    endDate: number;
  }
  

• 修改saveWorkout方法的参数类型，允许传入分段数组：

  export function saveWorkout(options: {
    // 保留原有参数...
    segments?: WorkoutSegment[];
  }): Promise<void>;
  

• 在RN到原生的参数传递逻辑中，将segments数组以JSON格式传入原生模块

3. RN端调用示例 #

修改后即可在业务代码中传入分段数据，实现铁人三项的分段记录：

import { saveWorkout, ActivityType } from '@kingstinct/react-native-healthkit';

// 铁人三项训练示例
await saveWorkout({
  activityType: ActivityType.Triathlon,
  startDate: Date.now() - 3600000, // 1小时前
  endDate: Date.now(),
  segments: [
    {
      activityType: ActivityType.Swimming,
      startDate: Date.now() - 3600000,
      endDate: Date.now() - 2700000 // 45分钟后结束游泳
    },
    {
      activityType: ActivityType.Cycling,
      startDate: Date.now() - 2700000,
      endDate: Date.now() - 900000 // 再30分钟骑行
    },
    {
      activityType: ActivityType.Running,
      startDate: Date.now() - 900000,
      endDate: Date.now() // 最后30分钟跑步
    }
  ]
});

注意事项 #

• 确保在Info.plist中添加对应HealthKit权限描述，包含子活动类型的权限声明
• 测试需在真实iOS设备上进行，模拟器对HealthKit的支持有限
• 若使用Swift编写原生代码，逻辑一致，只需转换为Swift语法的HKWorkoutSegment创建逻辑

内容的提问来源于stack exchange，提问作者Fariha Khalid