@capgo/capacitor-Asset-Cache

Lagere schwere CDN-Medien in der Anwendungs-eigenen persistenten Speicher und binden Bilder oder Videos an lokale WebView-URLs.

Loslegen GitHub

Nur lokale Anzeige von Quellen

src, resolve, und bind Nachdem ein lokales Datei existiert, wird eine Quelle zurückgegeben. Ihre img- oder video-Tags erhalten eine lokale WebView-URL.

Persistente native Speicherung

Gespeicherte Assets leben in der app-eigenen persistente Speicherung, nicht im Plattform-Cache-Ordner, der das System unter Druck evakuieren kann.

Schutzfunktion für CDN

Übergeben Sie Kopfzeilen an die native Fetch-Funktion für signierte oder authentifizierte Assets, während das Web-Element nur die lokale Datei lädt.

Frameworkfreundliche Bindung

Binde die native Cacheauflösung an einfaches HTML, React-Referenzen, Vue-Referenzen oder an jede Framework, die eine img- oder video-SRC zuweisen kann.

Übersicht

@capgo/capacitor-asset-cache Cache große Bilder, Videos und andere CDN-Assets in der app-eigenen persistente Speicherung, dann gibt die Web-App eine lokale Quellen-URL für die Anzeige.

Der normale Weg ist:

Konfigurieren Sie einmal eine CDN-Base-URL oder übergeben Sie eine absolute URL pro Asset.
Anrufen AssetCache.bind(element, path) oder AssetCache.src(path).
Alternativen oder
Das Plugin holt sich das Remote-Asset natively oder überprüft es erneut.

die Komponente als

Nutzen Sie den Asset Cache, wenn Ihre App schwerwiegende remote Medien anzeigt, die normalen Speicherdruck überstehen sollten:

onboarding- oder Marketing-Videos, die von einem CDN bereitgestellt werden
Heldenbilder, Galerien oder Bildsequenzen, die über Sitzungen hinweg wiederholt werden
Geschützte Medien, die Anforderungsheaders erfordern
Offline-tolerante Screens, bei denen ein zuvor abgerufenes lokales Asset ausreicht
Capacitor-Anwendungen, bei denen <img> und <video> und sollten geschützte URLs nicht direkt abrufen

Core API

configure(options) setzt Standard-CDN und -Revalidierungsverhalten fest.
bind(element, path, options?) aktualisiert ein Bild- oder Video-Element, wenn das lokale Datei bereit ist.
src(path, options?) gibt eine lokale Quellzeichenkette für das Framework-Zustand zurück.
resolve(path, options?) gibt die lokale Quellzeichenkette plus Cache-Metadaten zurück.
get(options) löst eine remote URL in persistente native Dateimetadata auf.
remove(options) entfernt ein einziges gecachtes Asset durch Schlüssel oder URL.
clear() entfernt alle gecachten Assets, die vom Plugin verwaltet werden.
list() gibt gecachte Assets zurück, die auf der Festplatte noch existieren.
getCacheSize() gibt die gesamten gecachten Bytes zurück.
getPluginVersion() gibt die native Implementierungsversionssymbol zurück.

Revalidierungsmodell

Der Cache kann auf verschiedene Weise pro Asset oder durch Standards überprüft werden:

Strategie	Verhalten
`never`	Verwenden Sie das lokale Datei, wenn sie vorhanden ist.
`ttl`	Wiederherunterladen nach `maxAgeSeconds`.
`always`	Bei jedem Aufruf erneut validieren und bekannte Validator senden.
`etag`	Verwenden Sie den bekannten HTTP ETag-Validator, wenn vorhanden.
`last-modified`	Verwenden Sie den bekannten HTTP Last-Modified-Validator, wenn vorhanden.

Speichermodell

Der Cache ist innerhalb des App-Sandbox versteckt und ist nicht als öffentliches Benutzermedium sichtbar. Er wird entfernt, wenn die App uninstalliert wird, wenn der Benutzer die App-Daten löscht oder wenn Ihre App

oder clear() Bleiben Sie bei @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache remove().

Keep going from @capgo/capacitor-asset-cache

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache verwenden @capgo/capacitor-asset-cache um persistente Medienbeladung zu planen, verbinden Sie es mit Zur Einführung für Implementierungsdetails @capgo/capacitor-downloader für explizite Hintergrunddownloads @capgo/capacitor-file für allgemeinen Zugriff auf lokale Dateien und Mit @capgo/capacitor-asset-cache für das Tutorial