@capgo/capacitor-almacenamiento-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 recibirá una URL de webview local.

Almacenamiento nativo persistente

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

Soporte de CDN protegido

Pasa 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 marcos

Unifique la resolución de caché nativa a HTML plano, referencias de React, referencias 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 al aplicativo web una URL de origen local para su visualización.

El camino normal es:

1. Configure una URL base de CDN una vez, o pase una URL absoluta por activo.
2. Llamar AssetCache.bind(element, path) o AssetCache.src(path).
3. El complemento obtiene o revalida el activo remoto nativamente.
4. El elemento recibe una URL de visualización web local solo después de que el archivo local esté listo.

Nota

Las APIs de visualización exitosas son solo locales. Si el complemento no puede crear o reutilizar un archivo local, src(...) y resolve(...) rechazar 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:

• videos de onboarding o marketing servidos desde una CDN
• imágenes de hero, galerías o secuencias de imágenes reutilizadas a través de sesiones
• medios protegidos que requieren encabezados de solicitud
• pantallas tolerantes a la falta de conexión donde un activo local previamente cargado es suficiente
• Capacitor aplicaciones <img> y debería no obtener URLs protegidas directamente <video> Núcleo __CAPGO_KEEP_0__

Sección titulada “Núcleo API”

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

Modelo de Revalidación

La caché puede ser verificada de diferentes maneras por activo o a través de valores por defecto:

Estrategia	Comportamiento
never	Utilizar el archivo local cuando esté presente.
ttl	Re-descargar después maxAgeSeconds.
always	Revalidar en cada llamada y enviar validadores conocidos.
etag	Utilizar el validador de ETag HTTP conocido cuando esté presente.
last-modified	Utilizar el validador de Fecha de Modificación 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 en 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 tu 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 de medios persistentes, conecta con Inicio rápido para detalles de implementación, @capgo/capacitor-descargador-de-fondo para descargas de fondo explícitas @capgo/capacitor-archivo para el acceso general a archivos locales, y Usando @capgo/capacitor-caché-de-recursos para el tutorial.