文件版本 v2026.07.07.0

下載 PDF

權限與檔案存取

頁面目標

協助你區分應用程式邏輯問題與系統檔案存取限制。

支援平台

• iOS
• macOS

適用對象

• 被檔案可見性或目的地存取問題阻擋的使用者
• 需要把權限問題與 App 邏輯失敗分開分析的測試人員

前置條件

• 已有具體匯入、匯出或拖放路徑失敗，或表現不如預期
• 你可以重試同一路徑，並觀察系統是否顯示權限提示

操作步驟

1. 重試同一路徑，留意系統權限提示。
2. 確認來源或目的地位置實際上可被 App 存取。
3. 檢查失敗是否符合平台特定規則，例如 iOS 上的 PNG -> Photos。
4. 記錄精確錯誤文字與大致位置。

結果

• 你可以判斷問題來自系統存取限制，還是其他應用層問題。

最常見的權限情境

• 檔案選擇器看不到目標資料
• 選取檔案後系統拒絕存取
• 匯出寫入目的地時失敗
• iOS 儲存到 Photos 失敗
• 拖放被系統阻擋

建議排查順序

1. 檢查系統是否顯示權限提示。
2. 確認目標資料位於 App 可存取的位置。
3. 在 iOS 上，記得 Photos 目的地只適用於 PNG。
4. 在 macOS 上，確認儲存面板選擇的目的地可寫入。
5. 重試完全相同路徑，確認問題是否重現。

幾個重要行為事實

• 如果使用者有意取消檔案選取，App 不會把它當成錯誤警示。
• 拖放匯入取決於系統是否提供有效 fileURL；沒有權限時，App 無法解析出檔案 URL。
• 在 iOS 上，匯出到 Photos 是獨立路徑，與一般 Files 匯出不同。

需要記錄什麼

• 平台與系統版本
• 大致目的地位置
• 系統是否顯示權限提示
• 失敗發生在匯入、匯出還是拖放
• 精確錯誤文字

常見問題

檔案存在，為什麼選擇器看不到？

多數情況下，這是系統存取範圍限制，而不是 App 不知道該檔案存在。請把檔案移到更直接可存取的位置後再試一次。

匯出失敗是否一定代表匯出功能壞了？

不一定。目的地不可寫、缺少權限，或格式與目的地不匹配，也可能造成匯出失敗。

為什麼儲存到 Photos 只支援 PNG？

因為 Photos 路徑連接的是 PNG；其他匯出格式使用 Files 或分享表單。