File Provider Extension: що це, розширення доступу до файлів iOS

Що таке File Provider Extension в iOS?

File Provider Extension — це розширення програми в iOS та macOS, яке дозволяє програмі надавати доступ до файлів із зовнішніх джерел через системний додаток Файли. Воно з'явилося в iOS 11 і замінило механізм Document Provider, додавши підтримку синхронізації, пошуку та тегів.

Основне завдання File Provider Extension — виступати мостом між зовнішнім сховищем (хмарним сервером, корпоративним NAS, FTP) та Files.app. Користувач бачить файли та теки так, ніби вони зберігаються локально, хоча дані можуть знаходитися на віддаленому сервері. Розширення працює фоново, синхронізуючи вміст за потреби.

Згідно з WWDC 2024, Apple активно розвиває FileProvider API: додано підтримку інкрементальної синхронізації, покращено продуктивність для великих каталогів та з'явилася можливість групових операцій. Це робить File Provider Extension приладнішим способом інтеграції зовнішніх файлів у екосистему Apple.

Як працює File Provider Extension

Архітектура File Provider Extension складається з двох компонентів: основного розширення (тип постачальника файлів) та опційного UI-розширення для автентифікації та конфігурації. Основне розширення реалізує протокол NSFileProviderExtension та обробляє всі запити від Files.app.

import FileProvider

class CloudFileProvider: NSFileProviderExtension {
    override func item(for identifier: NSFileProviderItemIdentifier) throws -> NSFileProviderItem {
        guard let item = storage
            .item(for: identifier) else {
            throw NSError(domain: NSFileProviderErrorDomain,
                              code: NSFileProviderError.noSuchItem.rawValue)
        }
        return item
    }

    override func urlForItem(with identifier: NSFileProviderItemIdentifier) -> URL {
        return fileCoordinator.urlForItem(with: identifier)
    }
}

Коли користувач відкриває Files.app та вибирає вашого постачальника, система запускає розширення у фоновому процесі. Розширення не має інтерфейсу користувача — це безголовний процес, який обробляє запити на читання, запис, перейменування та видалення файлів. Усі операції виконуються асинхронно через NSFileProviderManager.

Важливий нюанс: File Provider Extension живе в окремому процесі і може бути завершена системою при нестачі пам'яті. Тому постачальник повинен вміти відновлювати стан після перезапуску, зберігаючи ідентифікатори та кеш синхронізації у постійному сховищі.

Модель NSFileProviderItem: файли та теки

NSFileProviderItem — це протокол, який описує окремий файл або теку в ієрархії постачальника. Кожний елемент має унікальний ідентифікатор, ім'я, тип (файл або тека), дати створення та модифікації, розмір та прапорці (доступний офлайн, лише читання).

Протокол також підтримує розширені можливості через NSFileProviderItemProtocol: теги (кольорові мітки), іконки, версіонування та користувацькі дії. Для великих файлів реалізовано підтримку передачі, що підновлюються, через NSFileProviderService.

Згідно з WWDC 2023, Apple рекомендує використовувати замикання (NSFileProviderItemFields) для оновлення лише змінених властивостей замість цілого об'єкта. Це значно прискорює синхронізацію під час групових оновлень — наприклад, коли змінюється лише розмір групи файлів.

Рушій синхронізації та NSFileProviderManager

NSFileProviderManager — це центральний клас для керування життєвим циклом розширення. Він надає методи для сигналізації системі про зміни, обробки колаборативних конфліктів та керування завантаженнями. Менеджер автоматично відстежує активні передачі та надає пріоритет файлам, видимим користувачеві.

class SyncManager {
    let providerManager = NSFileProviderManager.default

    func signalUpdate(for item: NSFileProviderItemIdentifier) {
        providerManager.signalEnumerator(
            for: item.parentItemIdentifier
        ) { error in
            if let error = error {
                Logger.sync.error(
                    "Failed to signal: \(error.localizedDescription)"
                )
            }
        }
    }

    func uploadItem(at url: URL, itemId: NSFileProviderItemIdentifier) {
        providerManager.registerURLBasedItem(
            with: itemId,
            url: url
        )
    }
}

Рушій синхронізації — це логіка, яку розробник реалізує самостійно. Apple не надає вбудованого механізму синхронізації — лише API для сповіщення системі про зміни. Постачальник сам вирішує, як завантажувати файли з сервера, кешувати їх локально та вирішувати конфлікти редагування.

Конфлікти: система підтримує виявлення конфліктів версій через NSFileProviderSyncAnchor. Коли файл змінюється одночасно локально та віддалено, постачальник використовує якір синхронізації для визначення останньої синхронізованої версії та вирішує конфлікт за стратегією останній записувач перемагає або шляхом створення конфліктуючої копії.

Безпека та пісочниця розширення

File Provider Extension працює в суворій пісочниці (sandbox) iOS. Розширення не має прямого доступу до файлової системи програми-хоста, і навпаки — програма не може читати файли постачальника безпосередньо. Весь обмін даними відбувається через системні API Files.app.

Доступ до файлів користувача можливий лише через явну взаємодію: користувач відкриває файл з Files.app у програмі, і система створює тимчасову копію файлу в ізольованому контейнері. Програма-отримувач працює з цією копією, а не з оригіналом у сховищі постачальника.

Згідно з Apple Security Guide, 2024, постачальник зобов’язаний реалізувати шифрування даних під час передачі (TLS 1.3) та може опційно додати шифрування диска для кешованих файлів. Автентифікація користувача виконується через окремий компонент FileProviderUI, який працює поза пісочницею розширення для безпечного введення облікових даних.

Ключове обмеження: розширення не може виконувати довільний код — воно обробляє лише запити через NSFileProviderManager. Будь-яка логіка, що виходить за межі файлових операцій, повинна бути реалізована в основній програмі та викликатися через групи програм або XPC сервіси.