@capgo/capacitor-cache d'actifs

Affichage local uniquement des sources

src, resolve, et bind renvoie une source uniquement après qu'un fichier local existe. Votre balise img ou vidéo reçoit une URL de vue web locale.

Stockage de données natif persistant

Les actifs en cache vivent dans un stockage de données persistant appartenant à l'application, et non dans le dossier de cache de la plateforme que le système peut évacuer sous pression.

Support CDN protégé

Transmettre les en-têtes à la requête native pour les actifs signés ou authentifiés tout en chargeant uniquement le fichier local.

Liaison de liaison amicale avec le framework

Lier la résolution de cache natif à du HTML plat, des références React, des références Vue ou à tout framework pouvant attribuer une source img ou vidéo.

Vue d'ensemble

@capgo/capacitor-asset-cache cache de grandes images, vidéos et autres actifs CDN dans un stockage de données persistant appartenant à l'application, puis donne à l'application web une URL de source locale pour la mise en page.

La voie normale est :

1. Configurer une URL de base CDN une fois, ou passer une URL absolue par actif.
2. Appeler AssetCache.bind(element, path) ou AssetCache.src(path).
3. Le plugin récupère ou révalide le ressource distante de manière native.
4. L'élément reçoit une URL de vue web locale uniquement après que le fichier local est prêt.

Remarque

Les APIs de visualisation réussies sont locales uniquement. Si le plugin ne peut pas créer ou réutiliser un fichier local, src(...) et resolve(...) rejeter et bind(...) marque l'élément comme error.

Quand l'utiliser

Utilisez la cache d'actifs 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, de galeries ou de séquences d'images réutilisées au sein de sessions
• médias protégés qui nécessitent des en-têtes de requête
• écrans tolérants à l'offline où un actif local précédemment téléchargé est suffisant
• applications Capacitor où <img> et <video> ne doit pas télécharger directement les URL protégées

API

• configure(options) fixe les paramètres par défaut du CDN et du comportement de revalidation.
• bind(element, path, options?) met à jour un élément d'image ou de vidéo lorsque le fichier local est prêt.
• src(path, options?) renvoie une chaîne de source locale pour l'état du framework.
• resolve(path, options?) renvoie la source locale plus les métadonnées de cache.
• get(options) résout une URL distante en métadonnées de fichier natif persistant.
• remove(options) supprime un élément de cache par clé ou URL.
• clear() supprime tous les éléments de cache gérés par le plugin.
• list() renvoie les éléments de cache qui existent toujours sur le disque.
• getCacheSize() renvoie les octets de cache totaux.
• getPluginVersion() renvoie le marqueur de version de l'implémentation native.

Modèle de révalidation

Le cache peut être vérifié de différentes manières par élément ou par défaut :

Stratégie	Comportement
never	Utilisez le fichier local lorsque celui-ci est présent.
ttl	Re-téléchargez après maxAgeSeconds.
always	Validez à chaque appel et envoyez les validateurs connus.
etag	Utilisez le validateur HTTP ETag connu lorsque celui-ci est présent.
last-modified	Utilisez le validateur HTTP Last-Modified connu lorsque celui-ci est présent.

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édias utilisateur publics. Elle est supprimée 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().

Keep going from @capgo/capacitor-asset-cache

Si vous utilisez @capgo/capacitor-cache-d'actifs pour planifier le chargement persistant des médias, connectez-l’avec Prise en main pour les détails d'implémentation ; @capgo/capacitor-téléchargement pour les téléchargements de fond explicites ; @capgo/capacitor-fichier pour l'accès général aux fichiers locaux, et Utiliser @capgo/capacitor-cache-d'actifs pour le tutoriel.