ハンドブック版 v2026.04.17.1 公開日 2026-04-17

PDF をダウンロード

権限とファイルアクセス

目的

アプリ側のロジック問題と、システムのファイルアクセス制限を切り分けられるようにします。

対応プラットフォーム

• iOS
• macOS

対象読者

• ファイル可視性や保存先アクセスで詰まっているユーザー
• 権限問題とアプリロジック問題を分けたいテスター

前提条件

• インポート、エクスポート、またはドラッグ & ドロップの具体的な失敗事例がある
• 同じ経路を再試行し、システム側の権限表示を観察できる

手順

1. 同じ経路を再試行し、システムの権限ダイアログが出るか確認します。
2. ソースまたは保存先がアプリから実際にアクセス可能かを確認します。
3. PNG -> Photos のようなプラットフォーム固有条件に当てはまっていないか確認します。
4. 正確なエラーメッセージと対象位置を記録します。

結果

• 問題がシステムのアクセス制限によるものか、それ以外のアプリ側要因かを切り分けられます。

現在よくある権限シナリオ

• ファイルピッカーに対象データが見えない
• ファイル選択後にシステムがアクセスを拒否する
• 保存先への書き込み時にエクスポートが失敗する
• iOS で Photos 保存が失敗する
• ドラッグ & ドロップがシステムにブロックされる

推奨する確認順序

1. システムの権限ダイアログが出ていないか確認する
2. 対象データがアプリからアクセス可能な場所にあるか確認する
3. iOS では Photos 出力が PNG のみであることを確認する
4. macOS では保存ダイアログで選んだ保存先が書き込み可能か確認する
5. 同じ手順を再実行し、再現性を確認する

実装上知っておくとよい点

• ユーザーがファイル選択を意図的にキャンセルした場合、アプリはそれをエラー警告として扱いません。
• ドラッグ & ドロップのインポートは、システムから有効な fileURL が渡されることに依存します。権限がなければ解決できません。
• iOS の Photos 出力は、通常の Files 出力とは別経路です。

記録しておきたい情報

• プラットフォームとシステムバージョン
• 保存先や対象場所のおおまかな位置
• システムの権限ダイアログが出たか
• 問題がインポート、エクスポート、ドラッグ & ドロップのどれで起きたか
• エラーメッセージ原文

よくある質問

ファイルは存在するのに、なぜピッカーに見えないのですか？

多くの場合、原因はシステムのアクセス範囲制限であり、アプリがそのファイルを知らないからではありません。より直接アクセスしやすい場所へ移して、もう一度試してください。

エクスポート失敗は必ずエクスポート機能の不具合ですか？

いいえ。保存先が書き込み不可、権限不足、形式と保存先の不一致でも失敗します。

なぜ Photos 保存は PNG のみなのですか？

現在の実装では、Photos 経路が PNG にしか接続されていないためです。

最終確認日

• 2026-04-17