On Demand Resources queda obsoleto: lo que cuesta Background Assets

Apple retiró un sistema de entrega de contenido con una década encima en 13 palabras: «On Demand Resources y la API NSBundleResourceRequest quedan obsoletos. Usa Background Assets en su lugar».¹

Esa frase es la entrada completa. Lleva el radar 170066290, aparece bajo el apartado Deprecations y se repite palabra por palabra en tres notas de versión distintas.¹²³ Apple no publicó una versión de eliminación, ni una guía de migración asociada a la obsolescencia, ni una nota equivalente en las notas de versión de macOS o watchOS.

El trabajo se esconde en las últimas cuatro palabras. Background Assets no es una sola cosa: se bifurca en tres configuraciones con modelos de alojamiento distintos, objetivos de despliegue mínimos distintos y costos de migración separados por aproximadamente un orden de magnitud. La elección ocurre antes de que escribas una línea de código, y equivocarse ahí es el error caro.

En resumen

• Apple declaró obsoletos On Demand Resources y NSBundleResourceRequest en las notas de versión de iOS e iPadOS 27, tvOS 27 y visionOS 27.¹²³ ODR sigue funcionando: Apple no fijó fecha de eliminación, y las APIs obsoletas siguen incluidas y siguen resolviendo etiquetas.
• Los propios datos de disponibilidad de la API la declaran obsoleta en seis plataformas, dos más de las que menciona cualquier nota de versión: Mac Catalyst y watchOS.⁴ Background Assets no publica disponibilidad alguna para watchOS, así que watchOS recibe una obsolescencia sin reemplazo documentado.⁵⁶
• «Usa Background Assets en su lugar» se bifurca en tres caminos: gestionado con alojamiento de Apple, gestionado con alojamiento propio y no gestionado. Ambas rutas gestionadas exigen iOS 26.0 como objetivo de despliegue mínimo.⁷⁸ Por debajo de 26.0 solo queda abierta la ruta no gestionada, que te obliga a alojar los archivos, inventar el formato del manifiesto y analizarlo tú mismo.⁹
• La gestión de disco se invierte. ODR dejaba que el sistema purgara los recursos etiquetados sin usar y tomaba setPreservationPriority(_:forTags:) como una pista sobre el orden.⁴¹⁰ Background Assets conserva en el dispositivo todos los paquetes descargados hasta que tu código llame a remove(assetPackWithID:).¹¹
• Apple aloja hasta 200 GB de paquetes de recursos (asset packs) comprimidos y hasta 200 paquetes por registro de app, compartidos entre todas las plataformas que ofrece tu app, subidos a App Store Connect y revisados por separado de las compilaciones.¹²¹³

Qué declaró obsoleto Apple, exactamente

Tres detalles de la nota pesan, y la nota no menciona ninguno.

El alcance es más amplio que las notas de versión. La entrada aparece en tres documentos: iOS e iPadOS 27, tvOS 27 y visionOS 27, cada uno bajo un encabezado On Demand Resources con un subencabezado Deprecations y citando el mismo radar.¹²³ Las notas de macOS 27 y watchOS 27 no dicen nada al respecto.

La anotación de disponibilidad de la API cuenta una historia más amplia. NSBundleResourceRequest figura como introducida en iOS 9.0 y obsoleta en 27.0, con la misma obsolescencia en 27.0 para iPadOS 9.0, Mac Catalyst 13.1, tvOS 9.0, visionOS 1.0 y watchOS 2.0.⁴ Seis plataformas en los metadatos, cuatro nombradas en las notas. Los dos métodos de prioridad de conservación de Bundle llevan la misma anotación de seis plataformas.¹⁰ Una auditoría guiada solo por las notas de versión pasa por alto por completo las entradas de Mac Catalyst y watchOS.

La entrada de Mac Catalyst es nominal. Apple documenta que NSBundleResourceRequest «ignora las llamadas de las apps de Mac creadas con Mac Catalyst», de modo que la obsolescencia retira una API que allí nunca hizo nada.⁴ La entrada de watchOS no es nominal. Background Assets declara disponibilidad para iOS 16.0, iPadOS 16.0, Mac Catalyst 16.0, macOS 13.0, tvOS 18.4 y visionOS 2.4, sin fila para watchOS.⁵ Apple afirma sin rodeos que los paquetes de recursos alojados por Apple están «disponibles para apps distribuidas a través de la App Store en todas las plataformas excepto watchOS».⁶ Una app de watchOS que use ODR recibe una advertencia de obsolescencia y ningún reemplazo al que migrar.

La fuerza de este cambio es la más débil de los tres del ciclo 27 que he cubierto. Obsoleto significa obsoleto. Apple no publicó versión de eliminación, ni bloqueo en el envío, ni fallo en tiempo de ejecución. Compáralo con el mandato del ciclo de vida de escenas del mismo ciclo, donde las apps compiladas con el nuevo SDK «no se inician», o con el requisito de pantalla de inicio, donde la App Store rechaza la compilación de plano. ODR no hace ni lo uno ni lo otro. Las etiquetas existentes se siguen resolviendo, las llamadas existentes siguen devolviendo recursos y los binarios ya publicados siguen funcionando. Lo que llega es una advertencia del compilador y un reloj que nadie puede leer.

El momento se lee como una decisión, no como una limpieza. Apple declaró obsoleta la API en cuatro plataformas a la vez, un lanzamiento después de que se publicara el nivel gestionado de su reemplazo. Trata la obsolescencia como la apertura de una ventana de migración cuya duración Apple no ha publicado, no como una emergencia.

La bifurcación que eliges antes de escribir código

La descripción general del framework que publica Apple menciona dos modelos de alojamiento y un modo gestionado por defecto que «se encarga por ti de las descargas, las actualizaciones, la compresión y más». Con el alojamiento de Apple, «subes tus recursos a App Store Connect y los mantienes ahí, igual que las compilaciones de la app».⁵ La plantilla de extensión Background Download de Xcode nombra dos tipos directamente: gestionado con alojamiento de Apple y no gestionado con alojamiento propio.⁹¹¹ Una tercera combinación vive en las claves del property list: BAHasManagedAssetPacks en YES sin BAUsesAppleHosting selecciona paquetes de recursos gestionados que alojas tú mismo, y su documentación te dirige al protocolo ManagedDownloaderExtension en lugar del StoreDownloaderExtension de StoreKit.⁷⁸¹⁴

Para la mayoría de los equipos, la decisión la toma el objetivo de despliegue. Todo punto de entrada gestionado exige iOS 26.0 como mínimo, desde AssetPackManager y ManagedDownloaderExtension hasta las tres claves del property list.⁷⁸¹⁴¹⁵ Una app que dé soporte a iOS 18 no puede adoptar el nivel gestionado en absoluto, y sus opciones se reducen a la ruta no gestionada, que llega hasta iOS 16.1, o a seguir con el ODR obsoleto hasta que suba el objetivo de despliegue.⁹

La ruta no gestionada es otro trabajo distinto. En la secuencia de Apple, el sistema descarga un manifiesto desde BAManifestURL antes de que tu app se inicie, le entrega el archivo a tu extensión y recibe de vuelta un conjunto de solicitudes de descarga.⁹ Apple plantea el reparto sin matices: «Es tu responsabilidad crear los archivos de manifiesto de tus recursos autoalojados y no gestionados (con el formato que elijas) para que tu código los analice y entregue al sistema las URL y los tamaños de archivo».⁹ Tú pones el alojamiento, un CDN, un esquema de manifiesto, un analizador y una lista de dominios permitidos. Quien lea «usa Background Assets en su lugar» como un simple cambio de API está mirando el nivel gestionado y citando la factura del no gestionado.

Lo que ODR te daba y ahora reconstruyes a mano

Tres comportamientos de ODR no tienen equivalente directo.

Las etiquetas se convierten en paquetes de recursos. ODR identificaba el contenido con etiquetas de texto asignadas en Xcode, y NSBundleResourceRequest(tags:) reservaba una o varias.⁴ Background Assets sustituye las etiquetas por paquetes de recursos: carpetas de archivos descritas por un manifiesto JSON y comprimidas en un archivo .aar mediante una herramienta de línea de comandos. La unidad de granularidad crece, y la asignación sale del catálogo de recursos de Xcode para vivir en un archivo que mantienes tú.

El alojamiento de Apple se convierte en un tren de publicación aparte. El contenido de ODR viajaba con la compilación. Los paquetes de recursos alojados por Apple se suben de forma independiente mediante Transporter, altool, iTMSTransporter o la API de App Store Connect, y los envías a App Review por separado de la app.¹¹¹³ El desacoplamiento es justamente la ventaja: publicas contenido nuevo sin publicar una compilación. El costo es un segundo canal de envío, una segunda cola de revisión y un segundo conjunto de estados que vigilar.

La purga automática pasa a ser tarea tuya, y esa inversión es el cambio más brusco. ODR trataba el contenido descargado como una caché que pertenecía al sistema. Apple documentaba que el sistema «no intentará purgar del almacenamiento del dispositivo los recursos marcados con una etiqueta mientras al menos un objeto NSBundleResourceRequest esté gestionando esa etiqueta», lo cual es una promesa sobre cuándo ocurre la purga, no sobre si ocurre.⁴ setPreservationPriority(_:forTags:) existía precisamente para dar «una pista al sistema sobre el orden relativo para purgar conjuntos de recursos etiquetados dentro del bundle».¹⁰ Terminabas tu reserva, el sistema recuperaba el espacio a su propio ritmo y lidiar con la falta de almacenamiento era problema de Apple.

Background Assets invierte la propiedad. El sistema mantiene los paquetes actualizados de forma automática, y checkForUpdates() elimina los que quedaron obsoletos en el servidor.¹⁵ Ninguno de los dos mecanismos desaloja un paquete con el que simplemente terminaste. La instrucción de Apple es explícita: «el sistema no eliminará automáticamente tus paquetes de recursos mientras tu app esté instalada. Por lo tanto, cuando termines con un paquete de recursos, llama al método remove(assetPackWithID:)».¹¹

El patrón acotado y con conteo de referencias se reduce a un borrado explícito que tienes que decidir invocar:

// ODR: claim a tag, use the file, release the claim.
// The system reclaims the space afterward on its own schedule.
let request = NSBundleResourceRequest(tags: ["Tutorial"])
try await request.beginAccessingResources()
let url = Bundle.main.url(forResource: "Introduction", withExtension: "m4v")
request.endAccessingResources()

import System  // url(for:) and contents(at:) take a FilePath

// Background Assets: ensure the pack, read the file, delete the pack.
// Nothing reclaims the space if you skip the last line.
let manager = AssetPackManager.shared
guard let pack = try await manager.manifest.assetPack(withID: "Tutorial") else { return }
try await manager.ensureLocalAvailability(of: pack, requireLatestVersion: false)
let url = try manager.url(for: "Videos/Introduction.m4v")
try await manager.remove(assetPackWithID: "Tutorial")

Toda app que arrastre la suposición de desalojo de ODR necesita una política de almacenamiento escrita a propósito. El modo de fallo es silencioso: nada se cae, nada avisa y el almacenamiento del dispositivo sube hasta que alguien ve tu app en la lista de almacenamiento.

La superficie de migración, punto por punto

Para la ruta gestionada con alojamiento de Apple, los propios pasos de Apple producen esta lista de verificación.

Agrupa los archivos en paquetes de recursos y elige una política de descarga para cada uno. Existen tres. essential se descarga durante la instalación y alimenta la barra de progreso que la gente mira en la App Store, en TestFlight y en la pantalla de inicio. prefetch arranca durante la instalación y continúa en segundo plano una vez terminada. onDemand se descarga solo cuando tu código lo pide.¹¹ Para essential y prefetch, un array anidado installationEventTypes acepta firstInstallation, subsequentUpdate o ambos, de modo que un paquete de tutorial puede descargarse en la primera instalación y saltarse todas las actualizaciones posteriores.¹¹

Escribe un manifiesto por paquete. Xcode genera una plantilla comentada:

xcrun ba-package template -o Manifest.json

{
  "assetPackID": "Tutorial",
  "downloadPolicy": {
    "essential": {
      "installationEventTypes": ["firstInstallation"]
    }
  },
  "fileSelectors": [
    { "file": "Videos/Introduction.m4v" },
    { "directory": "Textures/Tutorial" }
  ],
  "platforms": ["<identifiers from the generated template comments>"]
}

Las rutas de archivo se resuelven en relación con la carpeta desde la que ejecutas el comando de empaquetado, algo que vuelve a importar más adelante, cuando leas los archivos por ruta.¹¹ Archiva cada paquete:

xcrun ba-package Manifest.json -o Tutorial.aar

Agrega un target de extensión Background Download dentro de Application Extension y elige como tipo el gestionado con alojamiento de Apple. Agrega la capacidad App Groups tanto a la app como a la extensión, y pon ambas en el mismo grupo. Después añade tres claves del property list al target de la app: BAAppGroupID, BAHasManagedAssetPacks en YES y BAUsesAppleHosting en YES. Apple indica que omitas cualquier otra clave de Background Assets en los proyectos alojados por Apple.¹¹ Hay una restricción con la que es fácil tropezar: adoptar AssetPackManager sin adoptar también el protocolo de extensión correspondiente es, en palabras de Apple, «un error de programación».¹⁵

La lectura de archivos funciona a través de un espacio de nombres unificado. Apple «fusiona automáticamente todos tus paquetes de recursos en un espacio de nombres compartido, reconstruyendo en la práctica la carpeta raíz de tus recursos como si estuviera pegada en el dispositivo de la persona», así que el código direcciona los archivos por ruta sin llevar cuenta de qué paquete los contiene.¹¹ Las lecturas devuelven por defecto un Data mapeado en memoria, con una variante de descriptor de archivo para carga procedural que debes cerrar tú.¹¹

Las pruebas locales traen un costo de configuración que conviene presupuestar aparte. Background Assets usa HTTPS en todas las descargas, así que el servidor simulado necesita un certificado. El camino documentado por Apple pasa por Acceso a Llaveros para crear una CA raíz autofirmada, Apple Configurator para armar un perfil que lleve esa CA, instalar ese perfil y marcarlo como de confianza en cada dispositivo de prueba, emitir un certificado SSL de hoja cuyo nombre coincida exactamente con la dirección IP o el nombre de host del servidor, iniciar el servidor y fijar una URL de sustitución en los ajustes de Developer de cada dispositivo.¹⁷

xcrun ba-serve --host localhost Tutorial.aar HighQualityTextures.aar

Presupuesta esa secuencia como una tarea propia. On Demand Resources no necesitaba en ningún momento un servidor tuyo: Apple lo describe como un gestor de «contenido alojado en la App Store», y los recursos que faltan en el dispositivo «se solicitan a la App Store».⁴ Migrar implica levantar alojamiento, o una imitación local en la que el dispositivo confíe, antes de poder ejercitar una sola descarga. Al leer los dos flujos de trabajo uno junto al otro, espero que sea la cadena de certificados, y no la adopción de la API, lo que consuma el primer día de una migración.

Las cifras con las que planificar

Apple publica dos topes duros para los paquetes alojados por Apple: 200 GB en total y 200 paquetes de recursos por registro de app. Ambos están «compartidos entre todas las plataformas que ofrece tu app».¹² Apple calcula el total a partir del tamaño máximo entre las versiones aptas para distribución en TestFlight o en la App Store, excluyendo las que están en Awaiting Upload, Processing, Failed y las totalmente Superseded, y te envía un correo al llegar al 80 % del límite. Archivar un paquete recupera espacio eliminando todas sus versiones, incluidas las que están publicadas en la App Store.¹²

La ruta no gestionada sustituye esos topes por cuatro claves de nivel superior del property list que fijas tú, una de ellas un diccionario que contiene tres más, y la división entre comprimido y sin comprimir es una trampa de verdad. BADownloadAllowance y BAEssentialDownloadAllowance limitan los tamaños de descarga y toman valores comprimidos. BAMaxInstallSize y BAEssentialMaxInstallSize limitan los tamaños instalados y toman valores sin comprimir.⁹ Apple acompaña las claves de tamaño de instalación con una advertencia que en realidad es una advertencia de producto: «La App Store usa esta clave para mostrar el tamaño de tu app en la página del producto, así que proporciona un valor exacto… No exageres el espacio en disco que necesitas».¹⁸ BADownloadDomainAllowList completa el conjunto y acepta dominios en formato DNS, con un asterisco inicial opcional para comodines.⁹

Falta una cifra más en el plan, y sale de los metadatos de disponibilidad antes que de la prosa. AssetPackManager llegó con iOS 26.0, y cuatro de sus miembros ya están marcados como obsoletos: ensureLocalAvailability(of:) y status(ofAssetPackWithID:) en 26.4, y luego assetPack(withID:) y allAssetPacks en 27.0.¹⁹ La búsqueda, el estado y la llamada de descarga se movieron una vez cada uno, en dos versiones menores. La ruta a la que Apple apunta ahora, a través de la propiedad manifest del gestor, lleva anotación de beta en el SDK de 27.0, igual que la variante por lotes ensureLocalAvailability(of:requireLatestVersions:).¹⁹ El propio tutorial de Apple sobre paquetes alojados por Apple todavía muestra dos de las llamadas obsoletas.¹¹ El piso práctico, por lo tanto, queda por encima del 26.0 nominal de ese nivel. Escribir la ruta de descarga que se mostró antes sin llevarte una advertencia de obsolescencia significa apuntar a 27.0 y aceptar símbolos anotados como beta para lograrlo. El reemplazo que te dicen que adoptes es más joven y se mueve más rápido que la API a la que sustituye.

A quién alcanza realmente la obsolescencia

La población afectada es reducida, y no la encontré en mi propio código. Busqué en siete proyectos publicados NSBundleResourceRequest, beginAccessingResources, setPreservationPriority, cualquier ajuste de compilación ON_DEMAND_RESOURCES, knownAssetTags y la configuración de etiquetas del catálogo de recursos. Cero coincidencias, en los siete, con todos los patrones. Un barrido de todos los archivos Swift, Objective-C, property list y pbxproj bajo mi carpeta de proyectos no devolvió nada para ningún símbolo de ODR, y tampoco nada para Background Assets.²⁰

El resultado nulo tiene una causa que vale la pena nombrar, porque se generaliza. ODR existe para apps cuyo contenido empequeñece su código. Mi catálogo de recursos más grande es el de Return, con 66,6 MB, y todas las demás apps están por debajo de 8 MB, con Water y Yawara por debajo de 100 KB.²⁰ A esos tamaños, partir el contenido en paquetes añade modos de fallo de red, una política de almacenamiento y un segundo canal de revisión, y a cambio ahorra una descarga de la que nadie se queja. Las apps que de verdad necesitan Background Assets son los juegos con contenido por niveles, las apps que distribuyen modelos grandes de machine learning y cualquier cosa con video por idioma, que es exactamente la población a la que apunta el soporte de paquetes de recursos localizados que Apple añadió en iOS 27.²¹

Los objetivos de despliegue afinan el panorama, y son la cifra que hay que revisar primero en cualquier código base. Cinco de mis seis apps de iOS ya están en iOS 26.0 o posterior, así que el nivel gestionado estaría disponible para ellas hoy mismo. Ace Citizenship todavía declara 17.0 y 17.5 en algunos de sus targets, lo que descartaría el nivel gestionado y dejaría solo la ruta no gestionada o el ODR obsoleto.²⁰ Haz esa comprobación antes de diseñar nada: el objetivo de despliegue mínimo, y no el peso de los recursos, es lo que decide qué migración te están ofreciendo en realidad.

Preguntas frecuentes

¿On Demand Resources deja de funcionar en iOS 27?

No. Apple marcó ODR y NSBundleResourceRequest como obsoletos y no publicó versión de eliminación, ni bloqueo en el envío, ni fallo en tiempo de ejecución.¹ Las APIs obsoletas siguen funcionando y las etiquetas existentes se siguen resolviendo. Lo que obtienes es una advertencia del compilador. El contraste con los otros cambios incompatibles del mismo ciclo es instructivo: el mandato del ciclo de vida de escenas hace que las apps «no se inicien», y el requisito de pantalla de inicio hace que la App Store rechace la compilación. La obsolescencia de ODR pone en marcha un reloj; no cierra una puerta.

¿Qué plataformas abarca la obsolescencia?

Las notas de versión nombran cuatro plataformas repartidas en tres documentos: iOS e iPadOS 27, tvOS 27 y visionOS 27, todos citando el radar 170066290.¹²³ Los metadatos de disponibilidad de la API son más amplios: marcan como obsoletos en 27.0 tanto NSBundleResourceRequest como los métodos de prioridad de conservación de Bundle en seis plataformas, sumando Mac Catalyst y watchOS.⁴¹⁰ Mac Catalyst es un caso teórico, porque Apple documenta que la clase ignora las llamadas de las apps de Catalyst.⁴ watchOS no es teórico: Background Assets no publica disponibilidad para watchOS, y los paquetes alojados por Apple están disponibles «en todas las plataformas excepto watchOS», así que una app de watchOS se queda con una API obsoleta y ningún sucesor documentado.⁵⁶

¿Puedo migrar si mi app da soporte a iOS 18?

Al nivel gestionado, no. AssetPackManager, ManagedDownloaderExtension, BAHasManagedAssetPacks y BAUsesAppleHosting exigen todos iOS 26.0.⁷⁸¹⁴¹⁵ Por debajo de ese piso quedan dos opciones. La ruta no gestionada funciona desde iOS 16.1, y te pide alojar los recursos, definir tu propio formato de manifiesto, analizarlo en una extensión y declarar los límites de descarga y una lista de dominios permitidos en tu property list.⁹ Si no, sigue usando el ODR obsoleto hasta que tu objetivo de despliegue llegue a 26.0, algo que la ausencia de una fecha de eliminación por parte de Apple permite hoy por hoy.

¿Qué se rompe en silencio si porto el código de ODR tal cual?

El almacenamiento. ODR dejaba que el sistema purgara el contenido etiquetado sin usar, y setPreservationPriority(_:forTags:) solo sugería un orden.⁴¹⁰ Background Assets nunca elimina un paquete con el que ya terminaste mientras tu app siga instalada, así que el espacio es tuyo hasta que llames a remove(assetPackWithID:).¹¹ El código que imita el viejo patrón de beginAccessingResources y endAccessingResources sin añadir un borrado explícito filtra disco de forma indefinida, sin caídas ni advertencias que lo delaten durante las pruebas. Escribe la política de eliminación antes de escribir el código de descarga.

Puntos clave

Para quienes desarrollan en iOS: - Revisa el objetivo de despliegue mínimo antes que nada. Por debajo de iOS 26.0 el nivel gestionado no existe para ti, y «usa Background Assets en su lugar» significa construir alojamiento, un formato de manifiesto y un analizador en la ruta no gestionada.⁷⁹ - Escribe una política de eliminación como parte de la migración. remove(assetPackWithID:) no tiene contraparte automática, y la vieja costumbre de ODR de soltar la reserva y confiar en el sistema deja el almacenamiento creciendo en silencio.¹¹

Para equipos que distribuyen contenido pesado: - Presupuesta la configuración de pruebas locales aparte del código. El camino documentado por Apple pasa por una CA raíz autofirmada, un perfil de Apple Configurator instalado y marcado como de confianza en cada dispositivo, un certificado SSL de hoja que coincida con el nombre de host del servidor y una URL de sustitución por dispositivo.¹⁷ - Planifica contra 200 GB y 200 paquetes por registro de app, compartidos entre todas las plataformas en las que publicas, y está atento al correo que Apple envía al 80 %.¹² Archivar para recuperar espacio elimina versiones que están publicadas en la App Store.¹²

Para quienes gestionan lanzamientos: - Los paquetes alojados por Apple implican un segundo canal de envío: se suben con Transporter o con la API de App Store Connect, se versionan de forma independiente de las compilaciones y se envían a App Review por su cuenta.¹¹¹³ Asigna personal al ciclo de revisión en consecuencia. - Nada obliga a migrar en este ciclo. Pon ODR después del mandato del ciclo de vida de escenas y del requisito de pantalla de inicio, que sí traen sanción real, y vuelve a evaluarlo cuando Apple publique una versión de eliminación.

El ciclo 27 sigue clasificando sus rupturas de compatibilidad según cuántos dientes tienen: el ciclo de vida de escenas impide que las apps se inicien, la pantalla de inicio impide que las compilaciones se publiquen y ODR apenas pone en marcha un reloj. Saber cuál es cuál es lo que te permite aprovechar bien el ciclo. Para el mismo patrón en una superficie más pequeña, mira la eliminación de ImageCreator de Image Playground. El centro de la serie completa es la serie sobre el ecosistema de Apple.

Referencias