@capgo/capacitor-cache de activos

Mostrar fuentes locales solo

src, resolve, y bind devuelve una fuente solo después de que exista un archivo local. Su etiqueta img o video recibe una URL de vista web local.

almacenamiento persistente nativo

Los activos en caché viven en el almacenamiento persistente propio de la aplicación, no en la carpeta de caché de la plataforma que el sistema puede eliminar bajo presión.

soporte de CDN protegido

Transmite encabezados a la llamada nativa de fetch para activos firmados o autenticados mientras el elemento web carga solo el archivo local.

vinculación amigable con el marco

Vincula la resolución de caché nativa a HTML plano, referencias de React, referencias de Vue o cualquier marco que pueda asignar una fuente img o video.

Resumen

@capgo/capacitor-asset-cache almacena grandes imágenes, videos y otros activos de CDN en el almacenamiento persistente propio de la aplicación, luego da a la aplicación web una fuente local URL para su visualización.

El camino normal es:

1. Configura una URL base de CDN una vez, o pasa una URL absoluta por activo.
2. Llamar AssetCache.bind(element, path) o AssetCache.src(path).
3. El plugin obtiene o revalida el recurso remoto nativamente.
4. El elemento recibe una URL de vista web local solo después de que el archivo local esté listo.

Nota

Las API de visualización exitosas son solo locales. Si el plugin no puede crear o reutilizar un archivo local, src(...) y resolve(...) rechaza y bind(...) marca el elemento como error.

¿Cuándo usarlo

Utilice la caché de activos cuando su aplicación muestra medios remotos pesados que deben sobrevivir a la presión de almacenamiento normal:

• vídeos de onboarding o marketing servidos desde una CDN
• imágenes de héroe, galerías o secuencias de imágenes reutilizadas en sesiones
• medios protegidos que requieren encabezados de solicitud
• pantallas tolerantes a la falta de conexión donde un activo local previamente descargado es suficiente
• aplicaciones Capacitor donde <img> y <video> no debe solicitar directamente URLs protegidas

Core API

• configure(options) establece el comportamiento de CDN y revalidación por defecto.
• bind(element, path, options?) actualiza un elemento de imagen o video cuando el archivo local está disponible.
• src(path, options?) devuelve una cadena de origen local para el estado del marco.
• resolve(path, options?) devuelve la fuente local más los metadatos de caché.
• get(options) resuelve una URL remota en metadatos de archivo nativo persistente.
• remove(options) elimina un activo caché por clave o URL.
• clear() elimina todos los activos caché gestionados por el plugin.
• list() devuelve activos caché que aún existen en disco.
• getCacheSize() devuelve bytes caché totales.
• getPluginVersion() devuelve el marcador de versión de la implementación nativa.

Modelo de Revalidación

La caché se puede verificar de diferentes maneras por activo o mediante valores por defecto:

Estrategia	Comportamiento
never	Utilice el archivo local cuando esté presente.
ttl	Re-descargar después de maxAgeSeconds.
always	Revalidar en cada llamada y enviar validadores conocidos.
etag	Utilice el validador de ETag HTTP conocido cuando esté presente.
last-modified	Utilice el validador de Modificado HTTP conocido cuando esté presente.

Modelo de almacenamiento

En iOS, los archivos se almacenan en Aplicación de soporte y la raíz de caché se excluye del respaldo de iCloud. En Android, los archivos se almacenan en el directorio de archivos internos de la aplicación.

La caché está oculta dentro del sandbox de la aplicación y no es visible como medios de usuario público. Se elimina cuando se desinstala la aplicación, cuando el usuario elimina los datos de la aplicación o cuando su aplicación llama clear() o remove().

Sigue adelante desde @capgo/capacitor-cache-de-activos

Si estás utilizando @capgo/capacitor-cache-de-activos para planificar la carga persistente de medios, conecta con Getting Started para obtener detalles de implementación @capgo/capacitor-descargador para descargas explícitas de fondo @capgo/capacitor-archivo para acceso general a archivos locales, y Usando @capgo/capacitor-cache-de-activos para el tutorial.