如何获取与健康应用格式一致的HealthKit记录数据？

苹果健康应用里的“所有记录数据”展示的是原始的HKQuantitySample数据，而非统计聚合后的结果——这是你当前使用HKStatisticsCollectionQuery出现数据差异的核心原因：该API是对时段内的数据进行聚合统计（比如按天/小时求和），而健康应用的“所有记录”是逐条展示未经加工的原始采样点。

正确的查询方式：使用HKSampleQuery #

要获取和健康应用完全一致的原始步数记录，需采用HKSampleQuery查询原始样本，具体实现步骤如下：

1. 定义步数数据类型

   let stepQuantityType = HKObjectType.quantityType(forIdentifier: .stepCount)!
   

2. 配置查询条件与排序规则
   指定查询的时间范围，并按采样开始时间升序排列（和健康应用的展示顺序一致）：

   let timePredicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: .strictStartDate)
   let sortDescriptor = NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: true)
   

3. 执行查询并处理结果

   let sampleQuery = HKSampleQuery(
       sampleType: stepQuantityType,
       predicate: timePredicate,
       limit: HKObjectQueryNoLimit,
       sortDescriptors: [sortDescriptor]
   ) { query, samples, error in
       guard let stepSamples = samples as? [HKQuantitySample], error == nil else {
           // 处理查询错误
           return
       }
       
       // 遍历原始样本，每条数据与健康应用“所有记录”条目一一对应
       for sample in stepSamples {
           let stepCount = sample.quantity.doubleValue(for: HKUnit.count())
           let sampleStartDate = sample.startDate
           let sampleEndDate = sample.endDate
           // 此处可直接使用原始数据做展示或处理
       }
   }
   
   healthStore.execute(sampleQuery)
   

补充说明 #

如果需要实时获取新增的步数数据，可以使用HKAnchoredObjectQuery，它能在有新数据产生时自动回调，适合做数据的增量同步。

苹果官方文档明确标注：若需获取未经聚合的原始健康数据样本，HKSampleQuery和HKAnchoredObjectQuery是标准方案，统计类查询仅适用于需要时段汇总的场景。

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