@capgo/capacitor-Asset-Cache

Nur lokale Anzeigequellen

src, resolve, und bind Gibt eine Quelle nur zurück, nachdem ein lokales Datei existiert. Ihre img- oder video-Tags erhalten eine lokale WebView-URL.

Persistente native Speicherung

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

Geschützter CDN-Unterstützung

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

Frameworkfreundliche Bindung

Bind native cache Auflösung an einfaches HTML, React-Referenzen, Vue-Referenzen oder an jede Framework, das eine img- oder video-Quelle zuweisen kann.

Übersicht

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

Der normale Weg ist:

1. Konfigurieren Sie einmal eine CDN-Base-URL oder übergeben Sie eine absolute URL pro Asset.
2. Aufrufen AssetCache.bind(element, path) oder AssetCache.src(path).
3. Der Plugin lädt oder überprüft die Remote-Ressource natively.
4. Der Element erhält eine lokale WebView-URL nur, nachdem das lokale Datei bereit ist.

Note

Ergebnisse werden lokal nur angezeigt. Wenn der Plugin keine lokale Datei erstellen oder wieder verwenden kann, src(...) und resolve(...) und bind(...) marks die Elemente als error.

Wann Sie es verwenden sollten

Verwenden Sie den Asset Cache, wenn Ihre App schwerwiegende remote-Medien anzeigt, die normaler Speicherdruck überstehen sollten:

• onboarding or marketing videos served from a CDN
• Heldenbilder, Galerien oder Bildsequenzen, die über Sitzungen hinweg wiederverwendet werden
• Geschützte Medien, die Anforderungsheaders erfordern
• Offline-tolerante Bildschirme, bei denen ein zuvor abgerufenes lokales Asset ausreicht
• Capacitor Apps, bei denen <img> und <video> Schützete URLs direkt nicht abrufen

Core API

• configure(options) Standardeinstellungen für CDN und Revalidierung setzen.
• bind(element, path, options?) Ein Bild- oder Videoelement aktualisiert, wenn das lokale Datei bereit ist.
• src(path, options?) Eine lokale Quellzeichenfolge für die Framework-Zustand zurückgeben.
• resolve(path, options?) Eine lokale Quellzeichenfolge plus Cache-Metadaten zurückgeben.
• get(options) Eine remote URL in persistente native Dateimetadata auflösen.
• remove(options) entfernt ein gecachtes Asset durch Schlüssel oder URL.
• clear() Alle gespeicherten Caches durch den Plugin verwaltet löschen.
• list() returns cached assets that still exist on disk.
• getCacheSize() Gesamte gecachte Bytes zurückgeben.
• getPluginVersion() Gibt die Versionsnummer der nativen Implementierung zurück.

Revalidierungsmodell

Die Cache-Einstellungen können je nach Asset oder durch Standards überprüft werden:

Strategie	Verhalten
never	Wenn ein lokales Datei vorhanden ist, wird diese verwendet.
ttl	Wiederherunterladen nach maxAgeSeconds.
always	Bei jedem Aufruf revalidieren und bekannte Validator senden.
etag	Use the known HTTP ETag validator when present.
last-modified	Verwenden Sie den bekannten HTTP Last-Modified-Validator, wenn dieser vorhanden ist.

Speichermodell

Bei iOS werden Dateien unter Application Support gespeichert und der Cache-Root wird aus dem iCloud-Backup ausgeschlossen. Bei Android werden Dateien unter dem internen Dateiverzeichnis des Apps gespeichert.

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

Weiter von @capgo/capacitor-Asset-Cache

Abschnitt mit dem Titel „Weitergehen von @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache“ @capgo/capacitor-Asset-Cache um persistente Medienbelastung zu planen, verbinden Sie es mit zum Planen von persistentem Medien-Loading verwenden Verbinden Sie es mit @capgo/capacitor-Downloader für explizite Hintergrunddownloads @capgo/capacitor-Datei für allgemeinen Zugriff auf lokale Dateien und Mit @capgo/capacitor-asset-cache für das Tutorial