SuperAPI AI 工具集

healthkit

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:在 Apple Health 中读取、查询和写入健康与健身指标,涵盖授权、数量样本、统计集合查询、后台投递和锻炼会话。目标环境为 Swift 6.3 / iOS 26+。

主要能力:在 Signing & Capabilities 中启用 HealthKit,如需后台观察更新则勾选 Background Delivery;在 Info.plist 声明 NSHealthShareUsageDescription(读取必需)、NSHealthUpdateUsageDescription(写入必需),访问临床记录时还需 NSHealthClinicalHealthRecordsShareUsageDescription。仅申请当前功能所需的类型,App Review 会拒绝申请多余健康权限的应用。

初始化须先用 HKHealthStore.isHealthDataAvailable() 判断可用性,再使用单例线程安全的共享 HKHealthStore。查询按用途选择:HKSampleQueryDescriptor 取原始样本;HKStatisticsQueryDescriptor 取单指标聚合;HKStatisticsCollectionQueryDescriptor 做时间序列聚合;HKAnchoredObjectQueryDescriptor 做增量同步;HKObserverQuery 触发后台投递。写入样本时单位须与数量类型匹配,累积型指标(步数、活动能量)的起止日期应覆盖测量区间,离散型(心率)起止日期相同。

使用方式与限制:统计与图表、后台投递、实时锻炼会话(HKWorkoutSession、HKLiveWorkoutBuilder)、HKUnit 格式等分别见对应章节。HealthKit 支持 iPhone、Apple Watch、iPad(iPadOS 17+)和 Vision Pro,iPadOS 16 及更早版本和受管理设备不可用。常见错误包括未检查可用性、缺少用法说明导致启动崩溃、创建多个 HKHealthStore 实例、假设可检查读取授权状态(Apple 出于隐私有意屏蔽)、使用不兼容单位。资料未提供具体价格或收费信息。