File Provider Extension: cos'è, estensione di accesso ai file iOS

Cos'è File Provider Extension in iOS?

File Provider Extension è un'estensione di app in iOS e macOS che consente a un'applicazione di fornire l'accesso a file da fonti esterne tramite l'app File di sistema. È stata introdotta in iOS 11 e ha sostituito il meccanismo Document Provider, aggiungendo il supporto per la sincronizzazione, la ricerca e i tag.

Il compito principale di File Provider Extension è fungere da ponte tra l'archiviazione esterna (server cloud, NAS aziendale, FTP) e Files.app. L'utente vede file e cartelle come se fossero archiviati localmente, sebbene i dati possano risiedere su un server remoto. L'estensione funziona in background, sincronizzando il contenuto secondo necessità.

Secondo la WWDC 2024, Apple sta sviluppando attivamente l'API FileProvider: è stato aggiunto il supporto per la sincronizzazione incrementale, le prestazioni per le directory di grandi dimensioni sono state migliorate e le operazioni batch sono ora disponibili. Questo rende File Provider Extension il metodo preferito per integrare file esterni nell'ecosistema Apple.

Come funziona File Provider Extension

L'architettura di File Provider Extension è composta da due componenti: l'estensione principale (tipo fornitore di file) e un'estensione dell'interfaccia utente opzionale per l'autenticazione e la configurazione. L'estensione principale implementa il protocollo NSFileProviderExtension e gestisce tutte le richieste da 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)
    }
}

Quando un utente apre Files.app e seleziona il tuo fornitore, il sistema avvia l'estensione in un processo in background. L'estensione non ha interfaccia utente — è un processo headless che gestisce le richieste di lettura, scrittura, ridenominazione ed eliminazione di file. Tutte le operazioni vengono eseguite in modo asincrono tramite NSFileProviderManager.

Sfumatura importante: File Provider Extension vive in un processo separato e può essere terminata dal sistema quando la memoria è scarsa. Pertanto, il fornitore deve essere in grado di ripristinare lo stato dopo un riavvio, salvando identificatori e cache di sincronizzazione nell'archivio persistente.

Modello NSFileProviderItem: file e cartelle

NSFileProviderItem è un protocollo che descrive un singolo file o cartella nella gerarchia del fornitore. Ogni elemento ha un identificatore univoco, nome, tipo (file o cartella), date di creazione e modifica, dimensione e flag (disponibile offline, sola lettura).

Il protocollo supporta anche capacità estese tramite NSFileProviderItemProtocol: tag (etichette colorate), icone, versionamento e azioni personalizzate. Per i file di grandi dimensioni, il supporto per i trasferimenti riprendibili è implementato tramite NSFileProviderService.

Secondo la WWDC 2023, Apple raccomanda di utilizzare le closure (NSFileProviderItemFields) per aggiornare solo le proprietà modificate anziché l'intero oggetto. Ciò accelera significativamente la sincronizzazione durante gli aggiornamenti batch — ad esempio, quando cambia solo la dimensione di un gruppo di file.

Motore di sincronizzazione e NSFileProviderManager

NSFileProviderManager è la classe centrale per la gestione del ciclo di vita dell'estensione. Fornisce metodi per segnalare al sistema le modifiche, gestire i conflitti collaborativi e gestire i download. Il manager tiene traccia automaticamente dei trasferimenti attivi e prioritizza i file visibili all'utente.

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
        )
    }
}

Il motore di sincronizzazione è la logica che lo sviluppatore implementa in modo indipendente. Apple non fornisce un meccanismo di sincronizzazione integrato — solo l'API per notificare al sistema le modifiche. Il fornitore decide autonomamente come scaricare i file dal server, memorizzarli nella cache locale e risolvere i conflitti di modifica.

Conflitti: il sistema supporta il rilevamento dei conflitti di versione tramite NSFileProviderSyncAnchor. Quando un file viene modificato contemporaneamente a livello locale e remoto, il fornitore utilizza l'ancora di sincronizzazione per determinare l'ultima versione sincronizzata e risolve il conflitto utilizzando una strategia di ultimo scrittore vince o creando una copia in conflitto.

Sicurezza e sandbox dell'estensione

File Provider Extension opera all'interno di una sandbox rigorosa di iOS. L'estensione non ha accesso diretto al file system dell'app host e, viceversa, l'app non può leggere direttamente i file del fornitore. Tutti gli scambi di dati avvengono tramite le API di sistema di Files.app.

L'accesso ai file dell'utente è possibile solo tramite interazione esplicita: l'utente apre un file da Files.app in un'applicazione e il sistema crea una copia temporanea del file in un contenitore isolato. L'app ricevente lavora con questa copia, non con l'originale nell'archivio del fornitore.

Secondo Apple Security Guide, 2024, il fornitore deve implementare la crittografia dei dati durante la trasmissione (TLS 1.3) e può opzionalmente aggiungere la crittografia del disco per i file memorizzati nella cache. L'autenticazione dell'utente viene eseguita tramite un componente FileProviderUI separato, che viene eseguito al di fuori della sandbox dell'estensione per l'immissione sicura delle credenziali.

Limitazione chiave: l'estensione non può eseguire codice arbitrario — elabora solo richieste tramite NSFileProviderManager. Qualsiasi logica oltre le operazioni sui file deve essere implementata nell'app principale e richiamata tramite gruppi di app o servizi XPC.