iCloud Drive: cos'è, archiviazione cloud Apple e come funziona

Cos'è iCloud Drive in iOS?

iCloud Drive è il servizio di file cloud di Apple che fornisce un archivio unificato di documenti per tutti i dispositivi dell'utente autorizzati con lo stesso Apple ID. Il servizio è stato lanciato nel 2014 insieme a iOS 8 e OS X Yosemite come sostituto di iCloud Documents.

iCloud Drive si differenzia da altri servizi di archiviazione cloud (Google Drive, Dropbox) per la sua profonda integrazione con il sistema operativo: i file appaiono direttamente in Finder su macOS e nell'app File su iOS, senza bisogno di installare un'app aggiuntiva. Il sistema sincronizza automaticamente il contenuto in background, alternando tra reti Wi-Fi e cellulari.

Secondo Apple Platform Overview, 2024, iCloud Drive supporta il versionamento dei file fino a 30 giorni, la condivisione di cartelle tramite iCloud Sharing e l'integrazione con la ricerca di sistema Spotlight. Gli sviluppatori accedono all'archiviazione tramite l'API NSFileCoordinator e i contenitori Ubiquity.

Architettura di iCloud Drive e Ubiquity

Ubiquity è un termine Apple che indica la capacità dei dati di essere “presenti ovunque.” Nel contesto di iCloud Drive, questo è un meccanismo che consente ai file di essere automaticamente sincronizzati su tutti i dispositivi dell'utente tramite il backend cloud CloudKit.

Il contenitore Ubiquity è una directory all'interno del Sandbox dell'app contrassegnata per la sincronizzazione. I file inseriti in questa directory vengono automaticamente caricati su iCloud Drive e distribuiti ad altri dispositivi. L'accesso al contenitore viene configurato tramite Capabilities in Xcode.

Il sistema tiene traccia dello stato di ciascun file tramite NSMetadataQuery: un file può essere locale (scaricato sul dispositivo), remoto (solo nel cloud) o in fase di download. Lo sviluppatore può richiedere programmaticamente il download di un file o verificarne la disponibilità prima di aprirlo.

Integrare iCloud Drive in un'app

L'integrazione di iCloud Drive inizia aggiungendo la capacità iCloud in Xcode e abilitando il servizio iCloud Documents. Successivamente, l'app ottiene l'accesso al contenitore Ubiquity, una directory speciale il cui percorso viene restituito tramite FileManager.

import UIKit

class DocumentManager {
    func ubiquityURL() -> URL? {
        return FileManager.default
            .url(forUbiquityContainer: nil)
    }

    func saveToICloud(data: Data, filename: String) {
        guard let containerURL = ubiquityURL() else { return }
        let fileURL = containerURL
            .appendingPathComponent(filename)

        do {
            try data.write(to: fileURL)
            Logger.storage.info(
                "Saved \(filename) to iCloud Drive"
            )
        } catch {
            Logger.storage.error(
                "Save failed: \(error.localizedDescription)"
            )
        }
    }

    func listICloudFiles() {
        let query = NSMetadataQuery()
        query.searchScopes = [NSMetadataQueryUbiquitousDocumentsScope]
        query.start()
    }
}

NSDocumentPickerViewController fornisce un'interfaccia utente di sistema per selezionare e importare file da iCloud Drive. L'utente vede un browser di file standard con supporto per ricerca, ordinamento e selezione multipla. Dopo la selezione del file, l'app riceve il suo URL e può lavorarci tramite NSFileCoordinator.

Regola importante: quando si lavora con file iCloud Drive, è necessario utilizzare NSFileCoordinator per la lettura e la scrittura. Ciò garantisce che il file non venga modificato da un altro processo (ad esempio, la sincronizzazione) durante l'operazione. Trascurare il coordinamento può portare al danneggiamento dei dati.

Risoluzione dei conflitti e NSFileVersion

Conflitti di versione si verificano quando un file viene modificato su due dispositivi contemporaneamente prima del completamento della sincronizzazione. iOS rileva automaticamente tali situazioni tramite NSFileVersion e crea versioni in conflitto che l'utente o l'app devono risolvere.

func resolveConflicts(for fileURL: URL) {
    let conflictVersions = NSFileVersion
        .unresolvedConflictVersionsOfItem(at: fileURL) ?? []

    for version in conflictVersions {
        do {
            let conflictData = try Data(contentsOf: version.url)
            let resolved = mergeData(
                original: try Data(contentsOf: fileURL),
                conflict: conflictData
            )
            try resolved.write(to: fileURL)
            version.remove()
        } catch {
            Logger.sync.error(
                "Conflict resolution failed: \(error)"
            )
        }
    }
}

NSFileVersion memorizza la cronologia delle modifiche del file fino a 30 giorni. Ogni versione contiene un URL, la data di creazione e l'identificatore del dispositivo che ha creato la versione. Il sistema contrassegna automaticamente le versioni come in conflitto quando due dispositivi inviano modifiche con lo stesso identificatore di base.

Strategie di risoluzione: l'app può unire automaticamente le modifiche (per i formati supportati), mostrare all'utente una scelta di versione o utilizzare una strategia “ultimo scrittore” (last-writer-wins). Apple raccomanda l'unione automatica per dati testuali e strutturati, e la visualizzazione delle versioni in conflitto per i formati binari.

Limiti di archiviazione e ottimizzazione

L'archiviazione gratuita di iCloud è di 5 GB, distribuita tra tutti i servizi dell'utente: backup, foto, posta e iCloud Drive. I piani a pagamento partono da 50 GB e arrivano fino a 12 TB. Per le applicazioni con scambio intensivo di file, è fondamentale tenere conto di questi limiti.

Ottimizzazione dell'archiviazione: iOS fornisce un meccanismo di espulsione dei file—quando lo spazio locale si esaurisce, il sistema può rimuovere le copie cache dei file iCloud Drive, lasciando solo i metadati. Quando si tenta di aprire tale file, il sistema lo scarica automaticamente dal cloud. Lo sviluppatore può controllare questo processo tramite NSFileCoordinator e verificare lo stato del file tramite NSMetadataUbiquitousItemDownloadingStatusKey.

Secondo WWDC 2022, Apple raccomanda le seguenti pratiche per ottimizzare iCloud Drive: archiviare solo i documenti dell'utente nel contenitore Ubiquity, non la cache dell'app; utilizzare il download asincrono con indicazione di progresso; fornire all'utente informazioni sulla dimensione del file prima del download; implementare il supporto per la ripresa di file di grandi dimensioni.

Sfumatura importante: l'eliminazione di un file dal contenitore Ubiquity lo rimuove da tutti i dispositivi dell'utente. Per i file temporanei, utilizzare la directory locale Documents anziché il contenitore Ubiquity. Si noti inoltre che la sincronizzazione non è istantanea—il ritardo può variare da pochi secondi a minuti a seconda della dimensione del file e della rete.