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 и избере вашия доставчик, системата стартира разширението във фонов процес. Разширението няма потребителски интерфейс — това е headless процес, който обработва заявки за четене, запис, преименуване и изтриване на файлове. Всички операции се изпълняват асинхронно чрез NSFileProviderManager.

Важна забележка: File Provider Extension живее в отделен процес и може да бъде прекратен от системата при недостиг на памет. Поради това доставчикът трябва да може да възстанови състоянието след рестарт, запазвайки идентификатори и кеш за синхронизиране в постоянно хранилище.

Модел NSFileProviderItem: файлове и папки

NSFileProviderItem е протокол, който описва отделен файл или папка в йерархията на доставчика. Всеки елемент има уникален идентификатор, име, тип (файл или папка), дати на създаване и модификация, размер и флагове (достъпен офлайн, само за четене).

Протоколът също поддържа разширени възможности чрез NSFileProviderItemProtocol: етикети (цветни маркери), икони, версиониране и персонализирани действия. За големи файлове се имплементира поддръжка за възобновяеми трансфери (resumable transfers) чрез 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) и може опционално да добави криптиране на диска за кеширани файлове. Удостоверяването на потребителя се извършва чрез отделен UI компонент FileProviderUI, който се стартира извън пясъчната кутия на разширението за безопасно въвеждане на идентификационни данни.

Ключово ограничение: разширението не може да изпълнява произволен код — обработва само заявки чрез NSFileProviderManager. Всяка логика, която излиза извън рамките на файловите операции, трябва да бъде имплементирана в основното приложение и извикана чрез app groups или XPC services.