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.