SuperAPI AI 工具集

healthkit

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:在 Apple 健康存储中读写健康与健身数据,覆盖授权、查询、写入、后台投递和锻炼会话,面向 Swift 6.3 / iOS 26+。

主要能力:检查可用性(HKHealthStore.isHealthDataAvailable());请求读写授权;用 HKSampleQueryDescriptor 做一次性样本读取;用 HKStatisticsQueryDescriptor 做聚合统计(累计型用 .cumulativeSum,离散型用 .discreteAverage/.discreteMin/.discreteMax);用 HKStatisticsCollectionQueryDescriptor 按时间间隔分组做图表数据,并可用 results(for:) 获取持续更新流;用 HKQuantitySample 写入数据;用 enableBackgroundDelivery 配合 HKObserverQuery 实现后台投递;用 HKWorkoutSession 与 HKLiveWorkoutBuilder 跟踪锻炼。

使用方式:在 Xcode 启用 HealthKit capability,在 Info.plist 添加 NSHealthShareUsageDescription 与 NSHealthUpdateUsageDescription;创建并复用单个 HKHealthStore;只请求真正需要的类型;优先使用 async 描述符而非回调查询;后台投递需启用对应子能力,并在应用启动时设置观察者查询、调用 completionHandler。

限制:读取授权被拒无法区分,查询可能只返回本应用保存的样本,表现为空或部分数据;应用只能删除自己创建的样本;后台投递在模拟器不支持,需真机测试且受系统频率上限约束;iPhone/iPad 实时心率需外接传感器;HKLiveWorkoutBuilder 仅 iOS/iPadOS 26+ 与 watchOS 5+;停止锻炼需等待委托 .stopped 后再 endCollection 与 finishWorkout。