Swift健身App添加训练段后Fitness App不显示问题求助

核心原因 #

原生Fitness App对训练段的展示依赖特定API实现，旧的HKWorkoutEvent方式（尤其是非.segment类型或缺少规范元数据）可能不被识别，而iOS 16+推出的HKWorkoutSegment是官方推荐的训练段实现方案，能确保Fitness App正常展示。

解决方案 #

1. 升级使用iOS 16+的HKWorkoutSegment API

这是最可靠的解决方式，完全适配原生App的训练段逻辑：

func saveSegment(startDate: Date, endDate: Date, segmentIndex: Int) async throws {
    guard let builder = builder else { return }
    // 创建训练段，可添加分段索引、名称等元数据
    let segment = HKWorkoutSegment(
        dateInterval: DateInterval(start: startDate, end: endDate),
        metadata: [
            HKMetadataKeyWorkoutSegmentIndex: segmentIndex,
            HKMetadataKeyWorkoutSegmentName: "训练段 \(segmentIndex)" // 可选，用于显示分段名称
        ]
    )
    // 通过builder添加训练段
    try await builder.addSegments([segment])
}

2. 确保Workout配置与保存流程正确

• 初始化HKWorkoutConfiguration时，明确设置正确的运动类型：

  let workoutConfig = HKWorkoutConfiguration()
  workoutConfig.activityType = .paddleSports
  workoutConfig.locationType = .outdoor // 根据训练场景调整为.outdoor/.indoor
  

• 训练结束时，正确完成数据收集与保存：

  // 结束实时数据收集
  try await builder?.endCollection(at: Date())
  // 完成并保存训练（包含所有训练段）
  let savedWorkout = try await builder?.finishWorkout()
  

3. 旧iOS版本兼容方案（iOS 15及以下）

如果必须兼容旧版本，需严格遵循Apple的元数据规范：

func saveSegment(startDate: Date, endDate: Date, segmentIndex: Int) async throws {
    guard let builder = builder else { return }
    let dateInterval = DateInterval(start: startDate, end: endDate)
    // 事件类型必须为.segment，且携带分段索引元数据
    let eventMetadata = [HKMetadataKeyWorkoutSegmentIndex: segmentIndex]
    let segmentEvent = HKWorkoutEvent(type: .segment, dateInterval: dateInterval, metadata: eventMetadata)
    // 设置Workout的分段风格元数据
    builder.metadata = [HKMetadataKeyWorkoutSegmentationStyle: HKWorkoutSegmentationStyle.segmented.rawValue]
    try await builder.addWorkoutEvents([segmentEvent])
}

注意：该方案无法保证在Fitness App中稳定显示，Apple已逐步用HKWorkoutSegment替代旧实现。

内容的提问来源于stack exchange，提问作者Iñaki Gomez