Swift Academy · Lezione

Directory della sandbox dell’app

Usi Documents, Caches e le posizioni temporanee.

Lezione 4 di 413 passaggi

Directory della sandbox dell’app è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.

Directory sandbox dell'app

Le app vengono eseguite in una sandbox: possono scrivere solo all'interno del proprio container. Esistono cartelle standard per documenti, cache e file temporanei.

Ricerca della directory Documents

FileManager.urls(for:in:) restituisce gli URL di una directory nota. .documentDirectory contiene i dati dell'utente di cui deve essere eseguito il backup.

import Foundation

let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
print("Documents path ends correctly: \(docs.lastPathComponent)")

Creazione degli URL dei file

Per ottenere il percorso completo dei propri file, aggiungete un nome di file all'URL della directory.

import Foundation

let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
let file = docs.appendingPathComponent("profile.json")
print(file.lastPathComponent)

La directory Caches

.cachesDirectory contiene dati che possono essere rigenerati. Il sistema potrebbe eliminarli quando lo spazio su disco è insufficiente, quindi non conservate qui dati insostituibili.

import Foundation

let fm = FileManager.default
let caches = fm.urls(for: .cachesDirectory, in: .userDomainMask).first!
print("Caches dir name: \(caches.lastPathComponent)")

La directory temporanea

FileManager.default.temporaryDirectory fornisce uno spazio di lavoro per file di breve durata, che dovrebbero essere eliminati dall'applicazione.

import Foundation

let tmp = FileManager.default.temporaryDirectory
let scratch = tmp.appendingPathComponent("work.tmp")
print("Temp file path ready: \(scratch.lastPathComponent)")

Documents, Caches e tmp a confronto

Utilizzate Documents per i dati creati dall'utente, di cui viene eseguito il backup, Caches per i dati riproducibili e tmp per i file temporanei.

import Foundation

// Choose the right folder for the data's lifetime.
print("Documents = backed up, Caches = purgeable, tmp = transient")

Application Support

.applicationSupportDirectory contiene dati gestiti dall'app e non direttamente visibili all'utente, come i database. Spesso è necessario crearla al primo avvio.

import Foundation

let fm = FileManager.default
let support = fm.urls(for: .applicationSupportDirectory, in: .userDomainMask).first!
try? fm.createDirectory(at: support, withIntermediateDirectories: true)
print("Ensured Application Support exists")

Salvataggio in Documents

Combinate l'URL della directory con un'operazione di scrittura per salvare i dati dell'utente all'interno della sandbox.

import Foundation

let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
let url = docs.appendingPathComponent("note.txt")
try? "hello".write(to: url, atomically: true, encoding: .utf8)
print("Saved into Documents")

Lettura dei dati

Leggete i file nella sandbox come qualsiasi altro URL di file, poiché il percorso è completamente valido all'interno del container.

import Foundation

let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
let url = docs.appendingPathComponent("note.txt")
if let text = try? String(contentsOf: url, encoding: .utf8) {
    print(text)
}

Esclusione dal backup

Impostate il valore della risorsa isExcludedFromBackup per i file grandi e rigenerabili, così da evitare che appesantiscano i backup di iCloud.

import Foundation

var url = URL(fileURLWithPath: "/tmp/big.cache")
var values = URLResourceValues()
values.isExcludedFromBackup = true
try? url.setResourceValues(values)
print("Marked excluded from backup")

Perché la sandbox è importante

I percorsi della sandbox cambiano a ogni installazione e su ogni dispositivo, quindi non codificateli mai direttamente. Risolvete sempre le directory a runtime con FileManager.

import Foundation

// Never hardcode /var/mobile/... — resolve at runtime instead.
let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
print("Resolved Documents dynamically: \(!docs.path.isEmpty)")

Verifica rapida

Quale directory deve contenere i dati dell'utente di cui deve essere eseguito il backup?

Riepilogo

Le app archiviano i file nelle cartelle della sandbox, individuate tramite FileManager.urls(for:in:): Documents per i dati dell'utente di cui viene eseguito il backup, Caches per i dati rigenerabili, tmp per i file temporanei, oltre ad Application Support. Risolvete i percorsi a runtime e non codificateli mai direttamente. Questo completa il corso di I/O sui file.

Gratis per iniziare

Impara Swift con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
122
Lezioni
409

Domande Frequenti

La lezione «Directory della sandbox dell’app» è gratuita?

Sì — il testo completo di «Directory della sandbox dell’app» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.

Cosa imparerò in «Directory della sandbox dell’app»?

Usi Documents, Caches e le posizioni temporanee. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Directory della sandbox dell’app»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. URL e percorsi dei file
  2. Lettura e scrittura dei dati
  3. Gestione delle directory
  4. Directory della sandbox dell’app
← Torna a Swift Academy