Fonti di visualizzazione locali
src, resolve, e bind ritorna una fonte solo dopo l'esistenza di un file locale. Il tuo tag img o video riceve un URL webview locale.
Storage persistente nativo
Gli asset memorizzati vivono nel storage persistente dell'applicazione, non nella cartella di cache del sistema che il sistema può evictare sotto pressione.
Sostegno CDN protetto
Passa i header al fetch nativo per gli asset firmati o autenticati mentre l'elemento web carica solo il file locale.
Legame amichevole del framework
Lega la risoluzione del cache nativo a HTML puro, React refs, Vue refs o a qualsiasi framework che possa assegnare una src per img o video.
Panoramica
Sottosezione intitolata “Panoramica”@capgo/capacitor-asset-cache cache 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.
La normale via è:
- Configura una URL base CDN una volta sola, o passa un'URL assoluta per asset.
- Chiamata
AssetCache.bind(element, path)orAssetCache.src(path). - Il plugin recupera o riconvalida nativamente l'asset remoto.
- L'elemento riceve una URL di visualizzazione web locale solo dopo che il file locale è pronto.
Quando Usarlo
Sezione intitolata “Quando Usarlo”Usa Asset Cache quando la tua app visualizza media remota 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 offline-tolleranti dove un asset locale precedentemente scaricato è sufficiente
- Capacitor applicazioni dove
<img>e<video>non dovrebbero recuperare direttamente URL protetti
configure(options)sets default CDN and revalidation behavior.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 di cache.get(options)risolve un URL remoto in metadati di file nativi persistente.remove(options)rimuove un asset di cache per chiave o URL.clear()rimuove tutti gli asset di cache gestiti dal plugin.list()ritorna gli asset memorizzati che ancora esistono sul disco.getCacheSize()ritorna il totale di byte memorizzati.getPluginVersion()ritorna il marchio di versione dell'implementazione nativa.
Modello di Revalidazione
Sottosezione intitolata “Modello di Revalidazione”Il cache può essere verificato in modi diversi per ogni asset o attraverso impostazioni predefinite:
| Tattica | Comportamento |
|---|---|
never | Utilizza il file locale quando presente. |
ttl | Riscarica dopo maxAgeSeconds. |
always | Rivaluta ogni volta e invia validatori noti. |
etag | Utilizza il validator noto ETag HTTP quando presente. |
last-modified | Usa il validatore HTTP Last-Modified noto quando presente. |
Modello di archiviazione
Sottosezione intitolata “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 il directory dei file interni dell'applicazione.
La cache è nascosta all'interno del sandbox dell'applicazione e non è visibile come media pubblica dell'utente. Viene rimossa quando l'applicazione viene disinstallata, quando l'utente cancella i dati dell'applicazione o quando la tua applicazione chiama clear() o remove().
Continua dall'@capgo/capacitor-cache di asset
Titolo della sezione “Continua da @capgo/capacitor-cache di asset”Sottosezione intitolata “Continua da @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache” @capgo/capacitor-cache di asset connettilo per pianificare il caricamento dei media persistente per pianificare il caricamento dei media persistenti, collega questo con ‘Inizia’ per i dettagli di implementazione, @capgo/capacitor-download per scarichi di background espliciti, @capgo/capacitor-file per l'accesso generale ai file locali, e Utilizzare @capgo/capacitor-asset-cache per il tutorial.