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 雖然提供請求與驗證權限的方法，但透過查詢資料直接測試是確認存取權限的最推薦方式。