SuperAPI AI 工具集

healthkit-code-review

测试与质量

查看项目

更新于 10-15 21:39

技能介绍

用途:审查使用 HealthKit 的代码,重点检查授权模式、查询用法、后台投递和数据类型处理。适用于代码中出现 import HealthKit、HKHealthStore 或 HK* API 的场景。

主要能力:提供四类参考文档——授权(HKHealthStore、权限、状态检查、隐私)、查询(HKQuery 类型、谓词、锚定查询、统计)、后台(后台投递、观察者查询、完成处理器)、数据类型(HKQuantityType、HKCategoryType、体能训练、单位)。附带审查清单,例如:任何 HealthKit 操作前调用 HKHealthStore.isHealthDataAvailable();仅申请所需数据类型(最小权限);不把 requestAuthorization 完成处理器误判为已授权;不尝试判断读取权限状态;查询结果派发到主线程更新 UI;HKObjectQueryNoLimit 仅与有界谓词同用;聚合使用 HKStatisticsQuery 而非手工求和;观察者查询的 completionHandler() 始终调用(可用 defer);后台投递在 application(_:didFinishLaunchingWithOptions:) 中注册;iOS 15+ 需添加后台投递 entitlement;数量类型使用正确单位(如心率用 count/min);长时查询存为属性并在 deinit 中停止。

使用方式:按审查门控顺序执行——先确定范围(列出使用 HealthKit 的文件路径与符号),再检查可用性与 store 创建,然后核对授权语义、查询与限制、观察者与后台、线程与生命周期;每步通过条件满足后才进入下一步。按主题加载对应参考文档:授权流程看 authorization.md,HKSampleQuery/HKAnchoredObjectQuery/谓词看 queries.md,HKObserverQuery/enableBackgroundDelivery 看 background.md,HKQuantityType/HKCategoryType/HKWorkout 看 data-types.md。

适用场景:iOS/macOS 健康数据相关代码的评审与自查。

限制:资料未提供具体安装命令、收费方式或平台支持范围;后台处理器约 15 秒限制、锚点需按样本类型分别持久化等属于清单中的检查点,实际行为需以代码与官方文档为准。