Ansehen auf __CAPGO_KEEP_0__
Anleitung
Using @capgo/capacitor-asset-cache
@capgo/capacitor-asset-cache Verwenden Sie @Capacitor/__CAPGO_KEEP_1__-asset-cache
Speichert große CDN-Bilder und -Videos in der app-eigenen persistenten Speicherung und gibt lokale Quell-URLs für __CAPGO_KEEP_0__-Webviews zurück.
npm install @capgo/capacitor-asset-cache
npx cap sync
Installieren
bindWas diese Erweiterung freigibtsrc- Befestigen Sie ein Bild- oder Videoelement an einer lokalen Assetquelle und aktualisieren Sie es, wenn es bereit ist.resolve- Rufen Sie die lokale Quelle plus Cache-Metadaten zurück.configure- Legen Sie die Standard-CDN- und Wiederherstellungsverhalten fest.get,list,remove,clear, undgetCacheSize- Verwalten Sie den Cache explizit, wenn erforderlich.
Beispielverwendung
Konfigurieren Sie eine CDN einmal, dann binden Sie Elemente über relative Pfade:
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');
}
Das Element erhält data-asset-cache-state="loading" während die native Fetch-Anfrage läuft, dann erhält es die lokale Quelle-URL und wechselt zu ready.
img[data-asset-cache-state='loading'],
video[data-asset-cache-state='loading'] {
opacity: 0.45;
}
Geschützte Assets
Kopfzeilen werden vom Plugin gesendet, während es die remote Datei abruft oder wiederherstellt. Das Web-Element erhält nur die lokale Quelle-URL.
const src = await AssetCache.src('private/videos/intro.mp4', {
cdnUrl: 'https://cdn.example.com/assets/',
headers: {
Authorization: `Bearer ${token}`,
},
});
Ohne CDN-Base-URL
Geben Sie eine absolute URL an, wenn Sie nicht möchten, dass eine Konfiguration durchgeführt wird. cdnUrl.
const src = await AssetCache.src('https://cdn.example.com/assets/videos/intro.mp4');
Relative Pfade erfordern entweder eine konfigurierte cdnUrl oder eine pro-Aufruf cdnUrl.
Speichernachrichten
Bei iOS leben Dateien unter Application Support und werden von iCloud-Backup ausgeschlossen. Bei Android leben Dateien unter dem internen Dateiverzeichnis der App. Das System behandelt diese Dateien nicht als verbrauchbare Cache-Dateien, sondern löscht sie bei Uninstall, App-Daten löschen, clear()und remove() dennoch löschen sie sie.
Vollständige Referenz
- GitHub: https://github.com/Cap-go/capacitor-asset-cache/
- Dokumentation: /docs/plugins/asset-cache/
Fortsetzen Sie mit der Verwendung von @capgo/capacitor-asset-cache
Wenn Sie die Nutzung von Mit @capgo/capacitor-asset-cache um persistente Medienbeladung zu planen, verbinden Sie es mit @capgo/capacitor-asset-cache zur Details der Implementierung, Anfänger zur Details der Implementierung, @capgo/capacitor-downloader zur expliziten Hintergrundherunterladen und @capgo/capacitor-file zur allgemeinen lokalen Dateizugriff.