常見問題與疑難排解

App 顯示「本版待印」——我的資料呢?

兩個常見原因:

1. **健康權限。**iOS 從不告訴 App「讀」權限給沒給——被拒絕和「沒資料」看起來 一模一樣。去 健康 → 頭像 → 隱私權 → App → Courier 打開類別開關。 (編輯部 → 資料來源有直達連結。)
2. **Apple 健康裡沒資料。**睡眠需要來源(Apple Watch 或寫入健康的睡眠 App);iOS 模擬器基本沒有健康資料——請用實機。

運動到了但沒有路線?/ 為什麼有條運動一直「等著」?

GPS 軌跡往往比運動摘要晚一點到達 Apple 健康。Courier 有意讓戶外運動停在 awaitingRoute,等軌跡到齊再發,而不是發出殘缺紀錄。若軌跡遲遲不來(比如 被誤判成戶外的室內運動,或手錶根本沒錄),項目會轉入待處理,由你手動 發行。

背景發行不是立刻的,壞了嗎?

沒壞——iOS 會節流背景投遞。幾分鐘到一小時左右都正常;最壞要等你下次打開 App。要保證馬上發出:打開 App,或跑立即發行捷徑。見 發行與同步。

重試會在我的伺服器上留重複嗎?

只要伺服器尊重 Idempotency-Key 標頭(或依 data.id upsert)就不會。自動 重試與手動重發複用同一個鍵;刻意的「再發一份」才輪換鍵(id#2、id#3 ……)。見發行與同步。

可以用純 HTTP 嗎?

真實端點要求 https://(iOS App Transport Security)。開發除錯允許 http://localhost / 區域網路位址。

我的端點想要另一種 payload 結構。

這正是JavaScript 轉換腳本的用途——回傳任意 字串或 JSON 結構。若只是想加幾個固定欄位,訂戶上的 Body 參數不用寫程式 就能做到。

在哪裡看傳送失敗的原因?

編輯部 → 發行台帳記錄每次嘗試,含 HTTP 狀態與回應摘要。轉換腳本的報錯也在 那裡,附腳本的錯誤訊息。

小工具是即時的嗎?

App 每次讀取或發行資料(含背景同步)都會重新整理它,另有 30 分鐘保底。顯示 過時?打開一次 App。見小工具。

我的資料在什麼雲端裡嗎?

Courier 不放任何雲端。無帳號、無開發者伺服器、無 CloudKit。僅有的網路去向是 你設定的端點(以及你若選用的轉寫服務)。見 隱私權政策。

如何換新 iPhone?

舊機:編輯部 → 設定備份 → 匯出;新機匯入,然後為每個訂戶重新輸入金鑰(金鑰 永不離開鑰匙圈)。批註可在批註存檔裡匯出 JSON。

其他問題。

帶上編輯部頁尾的版本號,來提 issue: github.com/Xheldon/Export-Data-From-Apple/issues。