Skip to content
Capgo - Capacitor アプリのリアルタイム更新 Capgo

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

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

ローカルのみ表示ソース

src, resolve, そして bind ローカルファイルが存在するまで、imgまたはvideoタグはローカルウェブビューのURLを受け取る。

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

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

保護されたCDNサポート

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

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

ネイティブキャッシュ解決をプレーンHTML、React参照、Vue参照、またはimgまたはvideo srcを割り当てることができるフレームワークにバインドします。

概要

セクションのタイトル “概要”

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

通常のパスは:

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

When To Use It

「When To Use It」というセクション

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

  • CDNから配信されるオンボーディングまたはマーケティングビデオ
  • セッションをまたいで繰り返し使用されるヘローアイコン、ギャラリー、またはイメージシーケンス
  • リクエストヘッダーが必要な保護されたメディア
  • __CAPGO_KEEP_0__ アプリ
  • Capacitor apps where <img> かつては <video> 直接保護されたURLを取得しないでください

コア API

セクション「コア 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既知のHTTP ETag検証者が存在する場合に使用します。
etag既知のHTTP Last-Modified検証者が存在する場合に使用します。
last-modifiedキャッシュが存在しない場合に再ダウンロードします。

ストレージモデル

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

iOSでは、ファイルはApplication Supportの下に保存され、iCloudバックアップからキャッシュルートが除外されます。 Androidでは、ファイルはアプリの内部ファイルディレクトリの下に保存されます。

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

「@capgo/capacitor-アセットキャッシュ」から続けてください

セクション「「@capgo/capacitor-アセットキャッシュ」から続けてください」

Capacitorを使用している場合 @capgo/capacitor-アセットキャッシュ 持続的なメディアのロードを計画する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-アセットキャッシュ を「Getting Started」 に接続して実装の詳細を参照してください @capgo/capacitor-ダウンローダー 明示的なバックグラウンドダウンロード用 @capgo/capacitor-ファイル 一般的なローカルファイルアクセス用、 @capgo/capacitor-アセットキャッシュ チュートリアル用に