@capgo/capacitor-cache-de-activos

Fuente de visualización local

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 webview local.

Almacenamiento persistente nativo

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

Protección de CDN

Envía encabezados a la solicitud nativa para activos firmados o autenticados mientras el elemento web carga solo el archivo local.

Enlace amigable con el framework

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

Resumen

@capgo/capacitor-asset-cache almacena grandes imágenes, videos y otros activos de CDN en almacenamiento persistente de la aplicación, luego proporciona una URL de origen local para la aplicación web.

El camino normal es:

1. Configura una URL base de CDN una vez, o pasa una URL absoluta por activo.
2. Llame AssetCache.bind(element, path) o AssetCache.src(path).
3. El plugin obtiene o revalida el activo remoto nativamente.
4. El plugin obtiene o revalida el activo remoto nativamente.

Nota

Las APIs 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

Utiliza la caché de activos cuando tu 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
• medios protegidos que requieren encabezados de solicitud
• contenido protegido de medios que requiere encabezados de solicitud
• pantallas tolerantes a la desconexión donde un activo local previamente cargado es suficiente
• aplicaciones Capacitor donde <img> y <video> no deben recuperar URLs protegidas directamente

Núcleo API

• configure(options) establece el comportamiento por defecto de CDN y revalidación.
• bind(element, path, options?) actualiza un elemento de imagen o video cuando el archivo local está disponible.
• src(path, options?) devuelve una cadena de fuente local para el estado del framework.
• 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 en caché que aún existen en disco.
• getCacheSize() devuelve bytes totales en caché.
• getPluginVersion() devuelve el marcador de versión de la implementación nativa.

Modelo de Revalidación

La caché puede ser verificada de diferentes maneras por activo o mediante valores por defecto:

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

Modelo de almacenamiento

En iOS, los archivos se almacenan bajo Aplicación de soporte y la raíz de caché se excluye del respaldo de iCloud. En Android, los archivos se almacenan bajo 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 la aplicación se desinstala, 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 conectarlo para planificar la carga persistente de medios para planificar la carga persistente de medios, conecte con ella a ‘Getting Started’ para detalles de implementación @capgo/capacitor-descargador para descargas de fondo explícitas @capgo/capacitor-archivo para acceso general a archivos locales, y Usando @capgo/capacitor-cache-de-activos para el tutorial.