Версія документа v2026.07.07.0

Дозволи та доступ до файлів¶

Цільова сторінка¶

Допомагає розрізнити проблеми логіки програми та обмеження доступу до системних файлів.

Підтримувані платформи¶

iOS/iPadOS: 17.0 або вище.
macOS: 14 або вище.

Кому це читати?¶

Користувачі застрягли з проблемами видимості файлу або доступу до місця призначення
Тестери, яким потрібно відокремити проблеми з дозволами від збоїв логіки програми

Передумови¶

Певний шлях імпорту, експорту або перетягування стався невдало або поводився несподівано
Ви можете повторити той самий шлях і спостерігати, чи система відображає запит на дозвіл

Етапи операції¶

Спробуйте повторити той самий шлях і зверніть увагу, чи система відображає запит на дозвіл.
Переконайтеся, що вихідне або цільове розташування дійсно доступне для програми.
Перевірте, чи збій відповідає правилам платформи, наприклад PNG -> Photos на iOS.
Запишіть точний текст помилки та приблизне місцезнаходження.

результат¶

Ви можете визначити, чи проблема пов’язана з обмеженнями доступу до системи чи іншою проблемою прикладного рівня.

Наразі найпоширеніші сценарії дозволів¶

Засіб вибору файлів не бачить цільові дані
Система забороняє доступ після вибору файлу
Помилка експорту під час запису в цільове розташування
Помилка збереження iOS у Photos
Перетягування заблоковано системою

Export save location and file access

Пропонований порядок усунення несправностей¶

Перевірте, чи система відображає запит на дозвіл.
Переконайтеся, що цільові дані зберігаються в місці, доступному для програми.
Запам’ятайте на iOS: націлювання Photos працює лише з PNG.
У macOS переконайтеся, що місце призначення, вибране на панелі збереження, доступне для запису.
Повторіть той самий шлях, щоб переконатися, що він повторюється.

Кілька видимих для користувача способів поведінки, які вам потрібно знати¶

Коли користувач активно скасовує вибір файлу, програма не розглядатиме це як спливаюче вікно з помилкою.
Перетягування імпорту залежить від системи, яка надає дійсний fileURL; без дозволу програма не може проаналізувати його.
В iOS експорт до Photos є окремим шляхом і не еквівалентний звичайному експорту Files.

FAQ¶

Файл, очевидно, існує, але чому його не видно в селекторі?¶

У більшості випадків це системне обмеження доступу, а не програма, яка не знає про файл. Перемістіть файл у більш доступне місце та повторіть спробу.

Якщо експорт не вдається, функція експорту повинна бути зламана?¶

невизначений. Цільове розташування неможливе для запису, відсутні дозволи або формат не відповідає цільовому розташуванню, що також може спричинити помилку експорту.

Чому збереження в альбом підтримує лише PNG?¶

Оскільки шлях Photos підключений до PNG; інші формати експорту використовують файли або панель спільного доступу до системи.