@capgo/capacitor-cache-locale

Caching i contenuti pesanti del CDN nella memoria persistente dell'applicazione e associare immagini o video a URL locali del webview.

Inizia GitHub

Visualizzazione di origine locale

src, resolve, e bind restituisci una risorsa solo dopo l'esistenza di un file locale. Il tuo tag img o video riceve un URL webview locale.

Memoria persistente nativa

I contenuti cached vivono nella memoria persistente dell'applicazione, non nella cartella di cache del sistema che il sistema può evitare sotto pressione.

Supporto CDN protetto

Passa i header al fetch nativo per i contenuti firmati o autenticati mentre l'elemento web carica solo il file locale.

Legame amichevole con il framework

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

Panoramica

@capgo/capacitor-asset-cache caching grandi immagini, video e altri asset CDN nel storage persistente di app proprietario, quindi fornisce all'app web una URL di origine locale per la visualizzazione.

Il percorso normale è:

Configura una URL base CDN una volta sola, o passa un'URL assoluta per asset.
Chiamata AssetCache.bind(element, path) o AssetCache.src(path).
Il plugin recupera o riconvalida l'asset remoto nativamente.
L'elemento riceve una URL di visualizzazione web locale solo dopo che il file locale è pronto.

Quando Usarlo

Usa Cache di Asset quando il tuo app visualizza media remoti pesanti che dovrebbero sopravvivere alla pressione normale di archiviazione:

video di onboarding o di marketing serviti da un CDN
immagini eroine, gallerie o sequenze di immagini riutilizzate all'interno di sessioni
media protetti che richiedono intestazioni di richiesta
schermate offline-tolleranti dove un asset locale precedentemente recuperato è sufficiente
app Capacitor dove <img> e <video> non dovrebbe recuperare direttamente le URL protette

Core API

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

Modello di Revalidazione

La cache può essere controllata in modi diversi per ogni risorsa o attraverso impostazioni predefinite:

Strategia	Comportamento
`never`	Utilizza il file locale quando presente.
`ttl`	Riscarica dopo `maxAgeSeconds`.
`always`	Rivalidare ogni volta che si chiama e invia validatori noti.
`etag`	Utilizza il validator noto ETag HTTP quando presente.
`last-modified`	Utilizza il validator noto Last-Modified HTTP quando presente.

Modello di archiviazione

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

La cache è nascosta all'interno del sandbox dell'app e non è visibile come media utente pubblico. Viene rimossa quando l'app viene disinstallata, quando l'utente cancella i dati dell'app, o quando il tuo app chiama clear() o remove().

Continua da @capgo/capacitor-cache-asset

Se stai utilizzando @capgo/capacitor-cache-asset per pianificare il caricamento dei media persistenti, connettilo con Iniziare per i dettagli di implementazione, @capgo/capacitor-downloadatore per scarichi di background espliciti, @capgo/capacitor-file per l'accesso ai file locali generici, e Utilizzare @capgo/capacitor-cache di asset per il tutorial.