Temporary Directory — cos'è, file temporanei e gestione dello storage

Cos'è Temporary Directory in iOS?

Temporary Directory (noto anche come tmp) è una directory all'interno della sandbox delle app iOS progettata per memorizzare dati la cui durata è limitata alla sessione corrente. È l'archivio più effimero tra tutte le directory della sandbox.

iOS fornisce tmp per operazioni che richiedono archiviazione intermedia di file: scaricare un file prima di spostarlo in Documents, creare una copia temporanea prima dell'esportazione, bufferizzare dati in streaming. Una volta completata l'operazione, i file temporanei devono essere eliminati.

Secondo la Documentazione Apple Developer (2024), la directory tmp è unica perché il suo percorso può cambiare tra le esecuzioni dell'app. iOS genera un nuovo percorso tmp a ogni avvio — questo garantisce che i dati della sessione precedente non vengano letti accidentalmente. Lo sviluppatore non deve mai salvare il percorso di tmp tra le esecuzioni.

Importante: a differenza di Caches Directory, dove i dati possono sopravvivere a diverse esecuzioni, tmp non garantisce la persistenza dei dati tra le sessioni a lungo termine. È il modo più affidabile per archiviare dati veramente temporanei.

Come ottenere il percorso di Temporary Directory

In Swift, per ottenere il percorso di tmp si usa la funzione globale NSTemporaryDirectory() o FileManager.temporaryDirectory. Queste sono le API più semplici tra tutte le directory della sandbox.

import Foundation

// Option 1: NSTemporaryDirectory()
let tempDir = NSTemporaryDirectory()
let tempFile = (tempDir as NSString)
    .appendingPathComponent("export_temp.pdf")

// Option 2: FileManager.temporaryDirectory (URL)
let tempURL = FileManager.default.temporaryDirectory
let exportURL = tempURL.appendingPathComponent("export_temp.pdf")

Objective-C usa la stessa funzione globale NSTemporaryDirectory(). Il risultato è una stringa con il percorso completo della directory temporanea dell'app.

@import Foundation;

NSString *tempDir = NSTemporaryDirectory();
NSString *tempFile = [tempDir stringByAppendingPathComponent:@"temp_data.bin"];

Una differenza fondamentale rispetto ad altre directory: NSTemporaryDirectory() non richiede di specificare un dominio o una maschera di ricerca — è una funzione globale. Tuttavia, il percorso potrebbe cambiare al prossimo avvio, quindi non salvarlo mai in UserDefaults o in altro archivio persistente.

Quali dati archiviare in tmp

Temporary Directory è destinata a un insieme rigorosamente definito di scenari. Gli sviluppatori spesso confondono tmp con Caches, inserendo in tmp dati che dovrebbero durare più di una sessione. Vediamo i casi d'uso corretti.

File intermedi durante l'esportazione

File creati durante l'esportazione dei dati: una copia temporanea di un report prima di inviarlo via email, un archivio compresso prima del caricamento, un file intermedio di conversione formato. Una volta completata l'esportazione, il file deve essere eliminato.

Bufferizzazione dei dati in streaming

Buffer temporanei per registrare audio, video o dati in streaming elaborati in tempo reale. Ad esempio, registrazione vocale prima di salvare nell'archivio permanente, o bufferizzazione del flusso video durante lo streaming.

Se i dati servono solo qui e ora — usa tmp. Se potrebbero essere utili nella prossima sessione — usa Caches. Se la perdita di dati è inaccettabile — usa Documents.

Ciclo di vita dei file temporanei

iOS gestisce il ciclo di vita di tmp in modo diverso dalle altre directory della sandbox. Comprendere questo ciclo è fondamentale per progettare correttamente l'archiviazione dei file nell'app.

A ogni avvio dell'app, iOS può allocare un nuovo percorso per tmp. Il percorso precedente diventa inaccessibile, sebbene i file fisici possano rimanere sul disco fino al riavvio del dispositivo. Questo è il motivo per cui Apple raccomanda vivamente di non salvare il percorso di tmp tra le sessioni.

Secondo Apple Tech Note TN2150 (2024), il sistema può cancellare tmp nei seguenti casi: riavvio del dispositivo, raggiungimento del limite di spazio su disco, scaricamento dell'app (Offload). A differenza di Caches, tmp non è progettato per conservare dati nemmeno tra più esecuzioni — è l'archivio meno affidabile della sandbox.

Lo sviluppatore deve eliminare esplicitamente i file temporanei dopo aver completato un'operazione usando FileManager.removeItem(at:). I file non eliminati in tmp si accumulano e sprecano spazio su disco — iOS non garantisce la loro pulizia automatica nel prossimo futuro.

Temporary Directory vs Caches Directory

Confrontare tmp e Caches aiuta gli sviluppatori a prendere la decisione giusta nella scelta di una directory per l'archiviazione. Una scelta errata può portare a una perdita prematura di dati o a un consumo di spazio non necessario.

Una regola pratica: scegli tmp per dati che verranno eliminati entro secondi o minuti dalla creazione. Scegli Caches per dati che è utile conservare per ore o giorni tra le sessioni ma che possono essere rigenerati.

Buone pratiche per lavorare con tmp

Lavorare con Temporary Directory richiede disciplina: poiché i dati in tmp sono di breve durata e il loro accumulo può portare a spreco di spazio, gli sviluppatori dovrebbero seguire diverse pratiche chiave.

Elimina sempre i file dopo l'uso

FileManager.removeItem(at:) deve essere chiamato immediatamente dopo aver completato un'operazione con un file temporaneo. Usa defer in Swift per garantire l'eliminazione anche in caso di errore.

import Foundation

let tempURL = FileManager.default
    .temporaryDirectory
    .appendingPathComponent("upload_temp.dat")

defer {
    try? FileManager.default.removeItem(at: tempURL)
}

// Work with temp file
try "temporary data".write(to: tempURL, atomically: true)
// ... file operation ...
// defer executes when scope exits

Non usare tmp per dati a lunga durata

Se i dati potrebbero servire un'ora dopo la creazione — salvali in Caches o Application Support. tmp è progettato per operazioni di minuti, non per l'archiviazione.

Seguire queste regole garantisce che i file temporanei non si accumulino, lo spazio su disco sia utilizzato in modo efficiente e l'app gestisca correttamente qualsiasi scenario di pulizia del file system iOS.