Affichage local uniquement des sources
src, resolve, et bind renvoyez une source uniquement après l'existence d'un fichier local. Votre balise img ou vidéo reçoit une URL de webview locale.
Stockage natif persistant
Les actifs en cache vivent dans le stockage persistant de l'application, et non dans le dossier de cache de la plateforme que le système peut évacuer sous pression.
Support CDN protégé
Transmettez les en-têtes à la requête native pour les actifs signés ou authentifiés tout en chargeant uniquement le fichier local.
Liaison amicale avec les frameworks
Attache la résolution de cache natif à HTML simple, les références React, les références Vue ou tout framework pouvant attribuer une source img ou vidéo.
Vue d'ensemble
Section intitulée “Vue d'ensemble”@capgo/capacitor-asset-cache cachent de grandes images, vidéos et autres actifs CDN dans un stockage persistant appartenant à l'application, puis donnent à l'application web une URL de source locale pour la mise en page.
La voie normale est :
- Configurez une URL de base CDN une fois, ou passez une URL absolue par actif.
- Appel
AssetCache.bind(element, path)ouAssetCache.src(path). - Le plugin récupère ou révalide l'actif distant nativement.
- L'élément reçoit une URL de vue web locale uniquement après que le fichier local est prêt.
Quand l'utiliser
Section intitulée “Quand l'utiliser”Utilisez le cache d'actif lorsque votre application affiche des médias distants lourds qui doivent survivre à la pression de stockage normale :
- vidéos de démarrage ou de marketing servies à partir d'un CDN
- images d'hero, galeries ou séquences d'images réutilisées au cours de sessions
- médias protégés qui nécessitent des en-têtes de requête
- écrans tolérants à l'arrêt où un actif local précédemment téléchargé est suffisant
- Capacitor applications où
<img>et ne doit pas récupérer directement les URL protégées<video>Core __CAPGO_KEEP_0__
Section intitulée “Core API”
Section titled “Core API”configure(options)met à jour un élément d'image ou de vidéo lorsque le fichier local est prêt.bind(element, path, options?)renvoie une chaîne de source locale pour l'état du framework.src(path, options?)renvoie la source locale plus les métadonnées de cache.resolve(path, options?)résout une URL distante en métadonnées de fichier natif persistant.get(options)supprime un élément de cache par clé ou par URL.remove(options)supprime tous les éléments de cache gérés par le plugin.clear()renvoie les éléments de cache qui existent toujours sur le disque.list()Core __CAPGO_KEEP_0__getCacheSize()renvoie les octets de cache totaux.getPluginVersion()renvoie le marqueur de version de l'implémentation native.
Modèle de révalidation
Section intitulée “Modèle de révalidation”La cache peut être vérifiée de différentes manières par asset ou par défauts :
| Stratégie | Comportement |
|---|---|
never | Utilisez le fichier local lorsque présent. |
ttl | Re téléchargez après maxAgeSeconds. |
always | Révalider à chaque appel et envoyez les validateurs connus. |
etag | Utilisez le validateur HTTP ETag connu lorsque présent. |
last-modified | Utilisez le validateur HTTP Last-Modified connu lorsque présent. |
Modèle de stockage
Section intitulée « Modèle de stockage »Sur iOS, les fichiers sont stockés sous Application Support et la racine de la cache est exclue de la sauvegarde iCloud. Sur Android, les fichiers sont stockés sous le répertoire de fichiers internes de l'application.
La cache est cachée à l'intérieur du sandbox de l'application et n'est pas visible comme média utilisateur public. Il est supprimé lorsque l'application est désinstallée, lorsque l'utilisateur supprime les données de l'application, ou lorsque votre application appelle clear() ou remove().
Continuez de @capgo/capacitor-cache d'asset
Section intitulée « Continuez de @capgo/capacitor-cache d'asset »Si vous utilisez @capgo/capacitor-cache d'asset pour planifier le chargement de médias persistants, connectez-le avec Getting Started pour les détails d'implémentation, @capgo/capacitor-téléchargeur pour les téléchargements de fond explicites, @capgo/capacitor-fichier pour l'accès local aux fichiers généraux, et En utilisant @capgo/capacitor-cache d'actif pour le tutoriel.