@capgo/capacitor-penyimpanan-aset-cache

Tampilkan sumber lokal saja

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

Penyimpanan native persisten

Aset yang dicache hidup di penyimpanan persisten yang dimiliki aplikasi, bukan folder cache platform yang mungkin dihancurkan oleh sistem di bawah tekanan.

Dukungan CDN yang dilindungi

Lampirkan header ke fetch native untuk aset yang ditandatangani atau terautentikasi sambil elemen web masih mengunduh hanya file lokal.

Pengikatan yang ramah framework

Hubungkan resolusi cache native ke HTML biasa, referensi React, referensi Vue, atau framework mana pun yang dapat menetapkan sumber img atau video.

Ringkasan

@capgo/capacitor-asset-cache Mengarsipkan gambar besar, video, dan aset CDN lainnya dalam penyimpanan persisten yang dimiliki aplikasi, kemudian memberikan aplikasi web sumber URL lokal untuk ditampilkan.

Rute normal adalah:

1. Konfigurasi URL dasar CDN sekali, atau lewatkan URL absolut per aset.
2. Panggil AssetCache.bind(element, path) atau AssetCache.src(path).
3. Plugin ini mengambil atau memvalidasi kembali aset remote secara native.
4. Elemen hanya menerima URL webview lokal setelah file lokal siap.

Catatan

Penggunaan API yang sukses adalah lokal saja. Jika plugin tidak dapat membuat atau menggunakan kembali file lokal, src(...) dan resolve(...) tolak dan bind(...) menandai elemen sebagai error.

Ketika Untuk Menggunakannya

Gunakan Cache Asset ketika aplikasi Anda menampilkan media remote berat yang harus bertahan di tekanan penyimpanan normal:

• video onboarding atau pemasaran yang disajikan dari CDN
• gambar hero, galeri, atau urutan gambar yang digunakan kembali di sesi
• media yang dilindungi yang memerlukan kepala permintaan
• layar yang toleran offline di mana aset lokal yang telah didapatkan cukup
• Capacitor aplikasi <img> dan tidak harus mengambil URL yang dilindungi secara langsung <video> Tidak boleh mengambil URL yang dilindungi secara langsung

Core API

• configure(options) mengatur perilaku CDN dan pengulangan default.
• bind(element, path, options?) mengupdate elemen gambar atau video ketika file lokal siap.
• src(path, options?) mengembalikan string sumber lokal untuk keadaan framework.
• resolve(path, options?) mengembalikan sumber lokal plus metadata cache.
• get(options) mengubah URL remote menjadi metadata file native yang persisten.
• remove(options) menghapus satu aset yang ditransaksikan dengan kunci atau URL.
• clear() menghapus setiap aset yang ditransaksikan oleh plugin.
• list() mengembalikan aset yang masih ada di disk.
• getCacheSize() returns total byte cache.
• getPluginVersion() returns native implementation version marker.

Model Revalidasi

Cache dapat dicek dalam cara yang berbeda per aset atau melalui default:

Strategi	Tindakan
never	Gunakan file lokal ketika ada.
ttl	Unduh ulang setelah maxAgeSeconds.
always	Revalidasi pada setiap panggilan dan kirimkan validator yang diketahui.
etag	Gunakan validator ETag HTTP yang diketahui ketika ada.
last-modified	Gunakan validator Last-Modified HTTP yang diketahui ketika ada.

Model Penyimpanan

Pada iOS, file-file disimpan di bawah Support Aplikasi dan root cache dikecualikan dari backup iCloud. Pada Android, file-file disimpan di bawah direktori file internal aplikasi.

Cache disembunyikan di dalam sandbox aplikasi dan tidak dapat dilihat sebagai media pengguna publik. Cache dihapus ketika aplikasi di-uninstall, ketika pengguna membersihkan data aplikasi, atau ketika aplikasi Anda memanggil clear() atau remove().

Lanjutkan dari @capgo/capacitor-cache-asset

Jika Anda menggunakan @capgo/capacitor-cache-asset untuk merencanakan muatan media yang persisten, hubungkan dengan Mulai untuk detail implementasi, @capgo/capacitor-downloader untuk pengunduhan latar belakang yang eksplisit, @capgo/capacitor-file untuk akses file lokal umum, dan Menggunakan pengunduh @capgo/capacitor-asset-cache untuk tutorial.