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

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

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-アセットキャッシュ
はじめに GitHub

Capgo

src, resolveローカル表示ソース bind , そして

パーシスタントネイティブストレージ

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

保護されたCDNサポート

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

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

ネイティブキャッシュ解決を、imgまたはvideo srcを割り当てることができる普通のHTML、React refs、Vue refs、またはいかなるフレームワークと結びつけることができます。

概要

セクションのタイトルは「概要」です。

@capgo/capacitor-asset-cache キャッシュされた大きな画像、動画、または他のCDNアセットは、アプリが所有するパーシスタントストレージ内にキャッシュされ、表示用のローカルソースURLをWebアプリに提供します。

通常のパスは次のとおりです。

  1. CDNのベースURLを一度設定するか、絶対URLをアセットごとに渡します。
  2. Call AssetCache.bind(element, path) または AssetCache.src(path).
  3. プラグインはリモートアセットをネイティブに取得または再検証します。
  4. 要素はローカルファイルが準備された後のみローカルウェブビューURLを受け取ります。

使用するとき

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

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

  • 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) キャッシュされたアセットを 1 つ削除します (キーまたは URL を使用)。
  • clear() キャッシュされたアセットをすべて削除します。
  • list() キャッシュされたアセットをディスク上でまだ存在するものを返します。
  • getCacheSize() キャッシュされたバイトの合計を返します。
  • getPluginVersion() ネイティブ実装バージョン マーカーを返します。

再検証モデル

「再検証モデル」

キャッシュはアセットごとに異なる方法でチェックできます。デフォルト値を使用することもできます。

戦略動作
neverローカルファイルを使用します。
ttl再ダウンロード後 maxAgeSeconds.
always毎回呼び出し時に有効な検証者を送信して再検証します。
etag有効なHTTP ETag検証者を使用します。
last-modified有効なHTTP Last-Modified検証者を使用します。

ストレージモデル

「ストレージモデル」のセクション

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

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

@capgo/capacitor-アセットキャッシュから続けます。

キャッシュを維持し続けるには、@capgo/capacitor-asset-cacheから続きます。

Capgoを使用している場合 capgo/capacitorアセットキャッシュ persistent media loading を計画するには、接続する 実装の詳細については 背景での明示的なダウンロードの場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-downloaderを参照してください。 背景での明示的なダウンロードの場合、@capgo/capacitor-downloaderを参照してください。 for explicit background downloads, @capgo/capacitorファイル Capgoを使用してください Using @capgo/capacitor-asset-cache __CAPGO_KEEP_0__