Una extensión de nuestra aplicación guarda un documento sin errores, pero después el usuario abre la aplicación Archivos y no lo encuentra. El archivo existe: simplemente está en una ubicación distinta de la que esperábamos. En iOS, compartir almacenamiento con una extensión y mostrar documentos en Archivos son problemas diferentes.
Cada proceso tiene su contenedor
Una extensión no hereda acceso al directorio Documents de la aplicación que la incluye. Apple explica en su guía de extensiones que ambos contenedores están separados. Obtener .documentDirectory desde la extensión devuelve su propio directorio, no el de la app principal.
La vía habitual para intercambiar datos es habilitar App Groups en ambos destinos de Xcode, con el mismo identificador. Así obtenemos un tercer contenedor al que pueden acceder los dos procesos.
Por ejemplo, una extensión para una app de recetas podría guardar una importación pendiente:
import Foundation
enum ImportError: Error {
case missingGroup
}
func savePendingRecipe(_ data: Data) throws -> URL {
let manager = FileManager.default
guard let root = manager.containerURL(
forSecurityApplicationGroupIdentifier: "group.com.example.recipes"
) else {
throw ImportError.missingGroup
}
let inbox = root.appendingPathComponent("Pending", isDirectory: true)
try manager.createDirectory(
at: inbox,
withIntermediateDirectories: true
)
let destination = inbox.appendingPathComponent("\(UUID()).json")
try data.write(to: destination, options: .atomic)
return destination
}
Este ejemplo crea archivos independientes con nombres únicos. Si ambos procesos modifican documentos compartidos, necesitan coordinar el acceso; una escritura atómica no sustituye esa coordinación.
Por qué no aparece en Archivos
El contenedor del grupo no se convierte automáticamente en la carpeta pública de la aplicación. Para exponer los documentos locales de una app convencional, podemos activar estas claves en su Info.plist:
<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>
Apple documenta que esta combinación permite mostrar el contenido de Documents en Archivos. No publica cualquier otra carpeta donde escribamos, ni concede a la extensión acceso al contenedor principal.
Una solución consiste en guardar las importaciones en el grupo y moverlas a Documents la próxima vez que se abra la app. Es válida si no hay prisa, pero si el usuario va a Archivos justo después de guardar, no encontrará nada hasta que abra la aplicación.
Usar un bookmark como puente
Otra posibilidad es compartir una referencia a la carpeta de destino. Un bookmark son los datos de una URL serializados en un Data, que podemos guardar y volver a convertir en URL más tarde. Si se creó con un security scope, al resolverlo recuperamos también el permiso de acceso que tenía la URL original.
En iOS, Apple describe este mecanismo para carpetas elegidas mediante el selector de documentos: recibimos una URL autorizada y guardamos sus datos con .minimalBookmark. Conocer la ruta de una carpeta no equivale a tener permiso para escribir en ella.
El enfoque que inspira este artículo propone crear un bookmark del Documents de la app, guardarlo en UserDefaults(suiteName:) del grupo y resolverlo desde la extensión. Así, el grupo transporta la referencia y los archivos se escriben directamente en el destino.
Conviene distinguir ese caso de la autorización obtenida mediante el selector. La documentación citada no establece una garantía general para transferir acceso persistente al Documents privado de la app a cualquier Share o Action Extension. Antes de adoptar ese diseño, hay que comprobar su comportamiento en los dispositivos y versiones compatibles, incluidos reinicios y actualizaciones.
Resolver la referencia y gestionar el acceso
Una vez obtenido un bookmark válido para el proceso que lo consume, la resolución debe tratar los errores y comprobar si la referencia necesita renovarse:
enum FolderAccessError: Error {
case staleBookmark
case accessDenied
}
func withBookmarkedFolder<T>(
_ bookmark: Data,
perform operation: (URL) throws -> T
) throws -> T {
var isStale = false
let folder = try URL(
resolvingBookmarkData: bookmark,
options: [],
relativeTo: nil,
bookmarkDataIsStale: &isStale
)
guard !isStale else {
throw FolderAccessError.staleBookmark
}
guard folder.startAccessingSecurityScopedResource() else {
throw FolderAccessError.accessDenied
}
defer { folder.stopAccessingSecurityScopedResource() }
return try operation(folder)
}
Este helper presupone una URL que requiere acceso de seguridad y rechaza referencias que necesitan renovación. El código que lo llama debe regenerarlas desde un contexto autorizado o solicitar de nuevo la selección de carpeta. Cada llamada a startAccessingSecurityScopedResource() que tiene éxito se cierra con su stopAccessingSecurityScopedResource(), incluso si el bloque lanza un error. Por eso la operación debe completarse dentro del bloque: si lanzamos una tarea asíncrona que use la URL, el acceso ya estará cerrado cuando se ejecute.
Diseñar también el caso de fallo
Si la extensión se ejecuta antes de que la aplicación haya preparado el bookmark, necesitamos una alternativa: conservar la importación en el grupo e indicar que está pendiente. Un permiso denegado o un error de escritura tampoco deben presentarse como un guardado completado.
Para documentos accesibles desde otros procesos, debemos coordinar las operaciones con NSFileCoordinator o UIDocument. También conviene definir cómo resolver nombres repetidos y evitar borrar el archivo anterior antes de asegurar su sustitución.
La decisión empieza por la experiencia que necesitamos: una bandeja compartida, documentos visibles en Archivos o una carpeta elegida por el usuario. Separar almacenamiento, permisos y visibilidad permite escoger una solución coherente y gestionar sus fallos sin perder importaciones.