Guida
Tutorial sul Cache degli Asset
Utilizza @capgo/capacitor-asset-cache
@capgo/capacitor-asset-cache immagazzina immagini e video CDN di grandi dimensioni nel storage persistente di app proprietario, quindi restituisce URL di origine locale per le Capacitor webviews.
Installa
npm install @capgo/capacitor-asset-cache
npx cap sync
Cosa questo plugin espone
bind- Collega un elemento di immagine o video a una fonte di asset locale e aggiornalo quando pronto.src- Restituisci una stringa di origine locale dopo che l'asset esiste localmente.resolve- Restituisci la fonte locale più i metadati della cache.configure- Imposta il comportamento predefinito per la revalidazione e il CDN.get,list,remove,clear, egetCacheSize- Gestisci la cache esplicitamente quando necessario.
Esempio di utilizzo
Configura un CDN una volta, poi lega gli elementi con percorso relativo:
import { AssetCache } from '@capgo/capacitor-asset-cache';
AssetCache.configure({
cdnUrl: 'https://cdn.example.com/assets/',
revalidate: {
strategy: 'ttl',
maxAgeSeconds: 86400,
},
});
const hero = document.querySelector<HTMLImageElement>('#hero');
if (hero) {
AssetCache.bind(hero, 'images/hero.jpg');
}
L'elemento riceve data-asset-cache-state="loading" mentre il fetch nativo esegue la richiesta, poi riceve l'URL della fonte locale e si sposta a ready.
img[data-asset-cache-state='loading'],
video[data-asset-cache-state='loading'] {
opacity: 0.45;
}
Asset Protetti
I header vengono inviati dal plugin mentre si esegue o si rinevalida il file remoto. L'elemento web riceve comunque solo l'URL della fonte locale.
const src = await AssetCache.src('private/videos/intro.mp4', {
cdnUrl: 'https://cdn.example.com/assets/',
headers: {
Authorization: `Bearer ${token}`,
},
});
Senza URL di base del CDN
Passa un URL assoluto quando non vuoi configurare l'URL di base del CDN cdnUrl.
const src = await AssetCache.src('https://cdn.example.com/assets/videos/intro.mp4');
I percorsi relativi richiedono o un configurato o un chiamato per cdnUrl o un chiamato per cdnUrl.
Nota sullo Storage
Su iOS, i file vivono sotto Application Support e sono esclusi dal backup iCloud. Su Android, i file vivono sotto il directory dei file interni dell'app. Il sistema non tratta questi file come file di cache disegnati, ma l'eliminazione dell'app, l'eliminazione dei dati dell'app, clear(), e remove() ,
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-cache-asset/
- Documentazione: /docs/plugins/cache-asset/
Continua da Utilizzo di @capgo/capacitor-cache-asset
Se stai utilizzando Usando @capgo/capacitor-cache-asset per pianificare il caricamento dei media persistente, connettilo con @capgo/capacitor-cache-asset per dettagli di implementazione, Avvio per dettagli di implementazione, @capgo/capacitor-download per scarichi di background espliciti, e @capgo/capacitor-file per l'accesso generale ai file locali.