コンテンツにジャンプ
Capgo - Capacitor アプリ向けライブアップデート Capgo

@capgo/capacitor-アセットキャッシュ

アプリ所有の永続ストレージに重いCDNメディアをキャッシュし、画像や動画をローカルウェブビューURLにバインドします。
はじめに GitHub

ローカルのみ表示ソース

src, resolve, そして bind ローカルファイルが存在する場合にのみソースを返します。imgまたはvideoタグはローカルウェブビューURLを受け取ります。

永続ネイティブストレージ

キャッシュされたアセットは、システムが圧力下で削除する可能性のあるプラットフォームキャッシュフォルダではなく、アプリ所有の永続ストレージに存在します。

保護されたCDNサポート

署名または認証されたアセットの場合、ヘッダーをネイティブのfetchに渡し、ウェブ要素はローカルファイルのみを読み込むようにします。

フレームワークフレンドリーなバインディング

フレームワークがimgまたはvideo srcを割り当てることができるHTML、React refs、Vue refsなどにnativeキャッシュ解決をバインドする

概要

概要

@capgo/capacitor-asset-cache キャッシュするのは、画像、動画、CDNアセットなどをアプリが所有する持続可能なストレージに保存し、表示用のローカルソースURLをWebアプリに提供する

通常のパスは

  1. CDNのベースURLを一度設定するか、またはアセットごとに絶対URLを渡す
  2. 呼び出し AssetCache.bind(element, path) または AssetCache.src(path).
  3. キャッシュするのは、画像、動画、CDNアセットなどをアプリが所有する持続可能なストレージに保存し、表示用のローカルソースURLをWebアプリに提供する
  4. キャッシュするのは、画像、動画、CDNアセットなどをアプリが所有する持続可能なストレージに保存し、表示用のローカルソースURLをWebアプリに提供する

使用するとき

「使用するとき」のセクション

アセットキャッシュを使用するには、通常のストレージ圧力で存続する必要がある重いリモートメディアを表示するアプリがあります。

  • オンボーディングまたはマーケティングビデオがCDNから提供される場合
  • ヒーロー画像、ギャラリー、またはシーケンス画像がセッションをまたいで繰り返し使用される場合
  • リクエストヘッダーが必要な保護されたメディア
  • オフライン耐性のある画面では、以前取得したローカルアセットが十分です
  • Capacitorアプリケーション <img> そして <video> 保護されたURLを直接取得しないでください

Core API

Core API
  • configure(options) デフォルトのCDNと再検証の動作を設定します。
  • bind(element, path, options?) ローカルファイルが利用可能になったときに画像または動画要素を更新します。
  • src(path, options?) フレームワークの状態に対するローカルソースの文字列を返します。
  • resolve(path, options?) ローカルソースとキャッシュメタデータを含むローカルソースを返します。
  • get(options) リモートURLを永続的なネイティブファイルメタデータに解決します。
  • remove(options) 指定されたキーまたはURLのキャッシュされたアセットを削除します。
  • clear() プラグインによって管理されるすべてのキャッシュされたアセットを削除します。
  • list() ディスク上にまだ存在するアセットをキャッシュから返します。
  • getCacheSize() キャッシュ内の合計バイト数を返します。
  • getPluginVersion() ネイティブ実装のバージョンマーカーを返します。

再検証モデル

「再検証モデル」のセクション

アセットごとに異なる方法で、またはデフォルトでキャッシュを確認できます。

戦略動作
neverローカルファイルが存在する場合に使用します。
ttl再ダウンロードするまでの時間 maxAgeSeconds.
always毎回呼び出され、知られている検証者を送信します。
etagHTTP ETag検証者を使用します。
last-modifiedHTTP Last-Modified バリデータを使用します。

ストレージ モデル

「ストレージ モデル」

iOS では、ファイルはアプリケーション サポート下に格納され、キャッシュ ルートは iCloud バックアップから除外されます。 Android では、ファイルはアプリ内ファイルディレクトリ下に格納されます。

キャッシュはアプリケーション サンドボックス内に格納され、パブリック ユーザー メディアとして表示されません。アプリがアンインストールされたとき、ユーザーがアプリデータをクリアしたとき、またはアプリが呼び出したときに削除されます。 clear() または remove().

Capgoから@capgo/capacitor-アセットキャッシュに進み続け

「@capgo/capacitor-アセットキャッシュ」から続ける

キャッシュ @capgo/capacitor-アセットキャッシュ キャッシュ キャッシュ 実装の詳細については @capgo/capacitor-ダウンローダ 明示的なバックグラウンドダウンロードの場合 @capgo/capacitor-ファイル 一般的なローカルファイルアクセス、そして @capgo/capacitor-アセットキャッシュを使用 チュートリアルについて