Directorios del entorno aislado de la app
Utilice Documents, Caches y ubicaciones temporales.
Directorios del entorno aislado de la app es una lección gratuita de Swift Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Swift Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Swift Academy incluye 4 lecciones en total.
Directorios del sandbox de la app
Las apps se ejecutan en un sandbox: solo pueden escribir dentro de su propio contenedor. Existen carpetas estándar para documentos, cachés y archivos temporales.
Buscar el directorio Documents
FileManager.urls(for:in:) devuelve las URL de un directorio conocido. .documentDirectory contiene datos del usuario que deben incluirse en las copias de seguridad.
import Foundation
let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
print("Documents path ends correctly: \(docs.lastPathComponent)")Construir URL de archivos
Añada un nombre de archivo a la URL del directorio para obtener una ruta completa para sus propios archivos.
import Foundation
let fm = FileManager.default
let docs = fm.urls(for: .documentDirectory, in: .userDomainMask).first!
let file = docs.appendingPathComponent("profile.json")
print(file.lastPathComponent)El directorio Caches
.cachesDirectory almacena datos que puede volver a generar. El sistema puede eliminarlos cuando queda poco espacio en disco, así que nunca guarde aquí datos irremplazables.
import Foundation
let fm = FileManager.default
let caches = fm.urls(for: .cachesDirectory, in: .userDomainMask).first!
print("Caches dir name: \(caches.lastPathComponent)")El directorio temporal
FileManager.default.temporaryDirectory proporciona un espacio de trabajo para archivos de corta duración que debe limpiar por su cuenta.
import Foundation
let tmp = FileManager.default.temporaryDirectory
let scratch = tmp.appendingPathComponent("work.tmp")
print("Temp file path ready: \(scratch.lastPathComponent)")Documents, Caches y tmp
Use Documents para los datos creados por el usuario (incluidos en las copias de seguridad), Caches para los datos reproducibles y tmp para los archivos desechables.
import Foundation
// Choose the right folder for the data's lifetime.
print("Documents = backed up, Caches = purgeable, tmp = transient")Application Support
.applicationSupportDirectory contiene datos gestionados por la app que no se muestran directamente al usuario, como bases de datos. Normalmente debe crearlo durante el primer lanzamiento.
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")Guardar en Documents
Combine la URL del directorio con una operación de escritura para conservar los datos del usuario dentro del 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")Leer datos guardados
Lea los archivos del sandbox igual que cualquier archivo identificado por una URL, ya que la ruta es totalmente válida dentro del contenedor.
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)
}Excluir de las copias de seguridad
Establezca el valor de recurso isExcludedFromBackup en los archivos grandes que se puedan volver a generar para que no hagan crecer innecesariamente las copias de seguridad de 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")Por qué importa el sandbox
Las rutas del sandbox varían según la instalación y el dispositivo, así que nunca las escriba directamente en el código. Resuelva siempre los directorios en tiempo de ejecución 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)")Comprobación rápida
¿Qué directorio debe contener los datos del usuario que deben incluirse en las copias de seguridad?
Resumen
Las apps almacenan archivos en carpetas del sandbox resueltas mediante FileManager.urls(for:in:): Documents para los datos del usuario incluidos en las copias de seguridad, Caches para los datos que se pueden volver a generar, tmp para los archivos temporales y Application Support. Resuelva las rutas en tiempo de ejecución; nunca las escriba directamente en el código. Con esto termina el curso de E/S de archivos.
Aprende Swift con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 122
- Lecciones
- 409
Preguntas frecuentes
¿La lección «Directorios del entorno aislado de la app» es gratis?
Sí — el texto completo de «Directorios del entorno aislado de la app» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Swift Academy, actualiza a CoddyKit PRO. El curso de Swift Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Directorios del entorno aislado de la app»?
Utilice Documents, Caches y ubicaciones temporales. Practicas Swift Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Swift Academy?
No se requiere experiencia previa. Swift Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Directorios del entorno aislado de la app»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Swift Academy?
Sí. Cada lección de Swift Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- URL y rutas de archivos
- Lectura y escritura de datos
- Gestión de directorios
- Directorios del entorno aislado de la app