@capgo/capacitor-cache d'actifs

Affichages locaux de 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 vue web locale.

Stockage de données natif persistant

Les assets stockés en cache résident dans un espace de stockage persistant dédié à l'application, et non dans le dossier de cache du système qui peut être évacué sous pression.

Support de CDN protégé

Transmettre les en-têtes à la requête native pour les actifs signés ou authentifiés tandis que l'élément web charge uniquement le fichier local.

Liaison amicale pour les frameworks

Associer 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 les grandes images, les vidéos et autres actifs CDN dans un stockage persistant appartenant à l'application, puis fournit à 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 l'asset distant 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 mise en page réussies sont locales uniquement. Si le plugin ne peut pas créer ou réutiliser un fichier local, src(...) et resolve(...) rejette et bind(...) marque l'élément comme error.

Quand l'utiliser

Utilisez Asset Cache lorsque votre application affiche des médias distants lourds qui devraient survivre à la pression de stockage normale :

• vidéos de démarrage ou de marketing servies à partir d'un CDN
• images d'accueil, galeries ou séquences d'images réutilisées entre sessions
• médias protégés qui nécessitent des en-têtes de requête
• écrans tolérants à l'offline où un asset local préalablement récupéré est suffisant
• applications Capacitor où <img> et <video> ne doit pas charger directement les URL protégées

noyau API

• configure(options) configure la stratégie CDN par défaut et la révalidation.
• 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?) retourne 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 persistantes.
• 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 le total des octets mis en cache.
• 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 présent.
ttl	Téléchargez à nouveau après maxAgeSeconds.
always	Revalidez à 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

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. Elle est supprimée lorsque l'application est désinstallée, lorsque l'utilisateur efface les données de l'application ou lorsque votre application appelle clear() ou remove().

Continuez à partir de @capgo/capacitor-asset-cache

Si vous utilisez @capgo/capacitor-cache-d'actifs pour planifier le chargement de médias persistants, 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 Utilisation de @capgo/capacitor-cache-d'actifs pour le tutoriel.