healthkit-cli

apple-health 是一个为基于 Expo 的 React Native 应用程序与 Apple HealthKit 之间提供完整连接的工具。它专为需要高效测试数据流程、无需在实体设备上手动输入数据的健身类应用程序开发者设计。通过专用的 CLI 工具与 React Hook，开发者可以轻松读取或写入超过 70 种测量类型、40 种类别类型与 80 种运动类型。无论是生成模拟健康数据、审核应用程序权限，还是可视化活动圆环，此工具都能提供稳定的接口来模拟复杂的用户健康概况。

• 广泛支持各类 HealthKit 数据，包括步数、心率、睡眠分析、营养指标与详细的运动参数。

• 内置强大的命令行接口，支持使用 NDJSON 进行大规模数据批量写入、查询历史记录与实时状态监控。

• 提供一系列 React Hook (如 usePermissions, useHealthKitQuery, useHealthKitStatistics)，简化 Expo 项目中的数据管理与界面整合。

• 支持渲染 Apple Watch 风格的活动圆环，提升用户健康进度的可视化反馈。

• 支持背景传输与实时订阅，确保应用程序在后台运行时仍能处理健康数据更新。

• 完整的 TypeScript 支持确保了从权限请求到复杂数据查询的所有交互皆具有类型安全性。

• 使用 CLI 前，请务必在 Expo 应用程序中加入 devtools hook (useHealthKitDevTools)，以建立终端与应用实例间的连接。

• 使用 bunx apple-health batch 指令导入大型数据集时，输入格式应为包含 start、duration 与 type 等属性的 NDJSON。

• 定义种子数据时，建议利用内置的日期格式功能，如相对偏移量 (例如 -1h, -2d) 或特定的 ISO8601 字符串。

• 此工具仅适用于具备 HealthKit 的 iOS 开发环境；针对 Web 与 Android 平台，工具内置了无操作 (no-op) 垫片以防止运行时错误。

• 请注意，Apple HealthKit 隐藏了读取权限的状态；SDK 虽然提供请求与验证权限的方法，但通过查询数据直接测试是确认访问权限的最推荐方式。