@capgo/capacitor-cache-asseti

Visualizzazione solo locale delle fonti

src, resolve, e bind restituisci una risorsa di origine solo dopo che esiste un file locale. Il tuo tag img o video riceve un URL di visualizzazione web locale.

Memoria di archiviazione nativa persistente

Gli asset memorizzati vivono nella memoria di archiviazione persistente di proprietà dell'applicazione, non nella cartella di cache del sistema che il sistema può cancellare sotto pressione.

Supporto CDN protetto

Passa i header alla fetch nativa per gli asset firmati o autenticati mentre l'elemento web carica solo il file locale.

Legame amichevole per il framework

Lega la risoluzione della cache nativa a HTML puro, riferimenti React, riferimenti Vue o a qualsiasi framework che possa assegnare una src per img o video.

Panoramica

@capgo/capacitor-asset-cache caching grandi immagini, video e altri asset CDN nella memoria di archiviazione persistente di proprietà dell'applicazione, poi fornisce all'app web un URL di origine locale per la visualizzazione.

Il percorso normale è:

1. Configura un URL base CDN una volta sola, o passa un URL assoluto per asset.
2. Chiama AssetCache.bind(element, path) o AssetCache.src(path).
3. O plugin recupera o riconvalida il file remoto nativamente.
4. L'elemento riceve un URL di visualizzazione locale solo dopo che il file locale è pronto.

Nota

Il display API è riuscito con successo. Se il plugin non può creare o riutilizzare un file locale, src(...) e resolve(...) rifiuta e bind(...) segna l'elemento come error.

Quando Usarlo

Usa il cache degli asset quando il tuo app visualizza media remoto pesanti che dovrebbero sopravvivere alla pressione di archiviazione normale:

• video di onboarding o di marketing serviti da un CDN
• immagini eroine, gallerie o sequenze di immagini riprese in diverse sessioni
• media protetti che richiedono intestazioni di richiesta
• schermate tolleranti all'offline dove un asset locale precedentemente recuperato è sufficiente
• Capacitor app dove <img> e <video> non dovrebbero essere recuperati direttamente gli URL protetti

Core API

• configure(options) impostano il comportamento predefinito del CDN e della riconvalidazione.
• bind(element, path, options?) aggiorna un elemento di immagine o video quando il file locale è pronto.
• src(path, options?) ritorna una stringa di origine locale per lo stato del framework.
• resolve(path, options?) ritorna la fonte locale più i metadati della cache.
• get(options) risolve una URL remota in metadati di file nativi persistenti.
• remove(options) rimuove un asset della cache per chiave o URL.
• clear() rimuove ogni asset della cache gestito dal plugin.
• list() ritorna gli asset della cache che ancora esistono su disco.
• getCacheSize() ritorna i byte totali della cache.
• getPluginVersion() ritorna il marchio di versione dell'implementazione nativa.

Modello di Revalidazione

Il cache può essere verificato in modi diversi per ogni asset o attraverso impostazioni predefinite:

Schema	Comportamento
never	Utilizza il file locale quando presente.
ttl	Riscarica nuovamente dopo maxAgeSeconds.
always	Rivaluta ogni volta e invia validatori noti.
etag	Utilizza il noto validator HTTP ETag quando presente.
last-modified	Utilizza il noto validator HTTP Last-Modified quando presente.

Modello di archiviazione

Sui dispositivi iOS, i file sono archiviati sotto Application Support e la radice del cache è esclusa dal backup iCloud. Sui dispositivi Android, i file sono archiviati sotto la directory dei file interni dell'applicazione.

Il cache è nascosto all'interno del sandbox dell'applicazione e non è visibile come media pubblica. Viene rimosso quando l'applicazione viene disinstallata, quando l'utente cancella i dati dell'applicazione o quando la tua applicazione chiama clear() o remove().

Keep going from @capgo/capacitor-asset-cache

Se stai utilizzando @capgo/capacitor-cache di asset per pianificare il caricamento dei media persistente, connettilo con Avvio rapido per i dettagli di implementazione, @capgo/capacitor-downloader per scarichi espliciti in background, @capgo/capacitor-file per l'accesso generale ai file locali, e Utilizzare @capgo/capacitor-cache di asset per il tutorial.