@capgo/capacitor-almacenamiento-de-asset

Mostrar fuentes locales solo

src, resolvey devuelve una fuente solo después de que exista un archivo local. Su etiqueta img o video recibirá una URL de webview local. bind Almacenamiento nativo persistente

y devuelve una fuente solo después de que exista un archivo local. Su etiqueta img o video recibirá una URL de webview local.

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

Soporte de CDN protegido

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

Enlace amistoso con el marco

Enlazar la resolución de caché nativa a HTML plano, refs de React, refs de Vue o cualquier marco 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 el almacenamiento persistente propio de la aplicación, luego da a la aplicación web una URL de fuente local para su visualización.

El camino normal es:

1. Configurar una URL base de CDN una vez, o pasar 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 muestre medios remotos pesados que deban sobrevivir a la presión de almacenamiento normal: videos de onboarding o marketing servidos desde una CDN

• ¿Cuándo usarlo
• imagenes, galerías o secuencias de imágenes reutilizadas a lo largo de sesiones
• medios protegidos que requieren encabezados de solicitud
• pantallas tolerantes a la falta de conexión donde un activo local previamente descargado es suficiente
• Capacitor aplicaciones donde <img> y <video> no deben solicitar URLs protegidas directamente

Core 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 en caché por clave o URL.
• clear() elimina todos los activos en caché gestionados por el plugin.
• list() devuelve activos en caché que aún existen en disco.
• getCacheSize() devuelve el total de bytes en caché.
• 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	Utiliza 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 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 contenedor de la aplicación y no es visible como medios de usuario públicos. 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().

Siga adelante desde @capgo/capacitor-cache de activos

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