Langsung ke konten

@capgo/capacitor-asset-cache

Cache gambar dan video CDN di penyimpanan aplikasi persisten dan hubungkan sebagai sumber media lokal

Sumber tampilan lokal saja

src, resolve, dan bind mengembalikan sumber hanya setelah file lokal ada. Tag img atau video Anda menerima URL webview lokal.

Penyimpanan native persisten

Aset yang di-cache disimpan di penyimpanan persisten milik aplikasi, bukan folder cache platform yang mungkin dihapus sistem saat beban tinggi.

Dukungan CDN terlindungi

Lewatkan header ke fetch native untuk aset yang ditandatangani atau terautentikasi, sementara elemen web hanya memuat file lokal.

Binding ramah framework

Hubungkan resolusi cache native ke HTML polos, React refs, Vue refs, atau framework apa pun yang dapat menetapkan src untuk img atau video.

Cache gambar dan video CDN di penyimpanan aplikasi persisten dan hubungkan sebagai sumber media lokal

Mulai dengan cancel() dan metode inti lainnya yang tercantum di bawah ini.

PlatformDukunganCatatan
iOSYaNative
AndroidYaNative
WebTidakLindungi dengan Capacitor.getPlatform()

Gunakan Asset Cache saat aplikasi Anda menampilkan media remote berukuran besar yang harus tetap bertahan meski penyimpanan tertekan:

  • video onboarding atau marketing dari CDN
  • hero image, galeri, atau urutan gambar yang dipakai ulang antar sesi
  • media terproteksi yang membutuhkan request header
  • layar toleran offline yang cukup dengan aset lokal yang sudah diambil sebelumnya
  • aplikasi Capacitor yang <img> dan <video> tidak boleh mengambil URL yang dilindungi secara langsung
  • configure(options) mengatur perilaku CDN dan revalidasi default.
  • bind(element, path, options?) memperbarui elemen gambar atau video saat file lokal siap.
  • src(path, options?) mengembalikan string sumber lokal untuk state framework.
  • resolve(path, options?) mengembalikan sumber lokal beserta metadata cache.
  • get(options) menyelesaikan URL jarak jauh menjadi metadata file native yang persisten.
  • remove(options) menghapus satu aset cache berdasarkan key atau URL.
  • clear() menghapus semua aset cache yang dikelola oleh plugin.
  • list() mengembalikan aset cache yang masih ada di disk.
  • getCacheSize() mengembalikan total byte yang di-cache.
  • getPluginVersion() mengembalikan penanda versi implementasi native.

Cache dapat diperiksa dengan cara yang berbeda per aset atau melalui default:

StrategiPerilaku
neverGunakan file lokal jika ada.
ttlUnduh ulang setelah maxAgeSeconds.
alwaysRevalidasi pada setiap panggilan dan kirim validator yang diketahui.
etagGunakan validator HTTP ETag yang diketahui bila tersedia.
last-modifiedGunakan validator HTTP Last-Modified yang diketahui bila tersedia.

Di iOS, file disimpan di Application Support dan root cache dikecualikan dari backup iCloud. Di Android, file disimpan di direktori files internal aplikasi.

Cache tersembunyi di dalam sandbox aplikasi dan tidak terlihat sebagai media publik pengguna. Cache akan dihapus saat aplikasi di-uninstall, saat pengguna menghapus data aplikasi, atau saat aplikasi Anda memanggil clear() atau remove().

Jika Anda menggunakan @capgo/capacitor-asset-cache untuk merencanakan pemuatan media persisten, hubungkan dengan Panduan Memulai untuk detail implementasi, @capgo/capacitor-downloader untuk download background secara eksplisit, @capgo/capacitor-file untuk akses file lokal secara umum, dan Menggunakan @capgo/capacitor-asset-cache untuk tutorialnya.