@capgo/capacitor-asset-cache

Tampilkan sumber lokal saja

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

Penyimpanan Data Asli

Aset yang disimpan tetap ada di penyimpanan penyimpanan persisten yang dimiliki aplikasi, bukan folder cache platform yang mungkin dihapus oleh sistem di bawah tekanan.

Dukungan CDN yang Dilindungi

Lampirkan kepala ke native fetch untuk aset yang ditandatangani atau terautentikasi sambil web element masih mengisi file lokal saja.

Pengikat yang Ramah Framework

Tetapkan resolusi cache native ke HTML biasa, refs React, refs 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 di penyimpanan penyimpanan persisten yang dimiliki aplikasi, kemudian memberikan aplikasi web sumber daya lokal URL untuk ditampilkan.

Jalur Normalnya:

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

Catatan

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

Menggunakan Apa

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

• video onboarding atau iklan yang disajikan dari CDN
• gambar hero, galeri, atau urutan gambar yang digunakan kembali di sesi
• media yang dilindungi yang memerlukan header permintaan
• layar offline-toleran di mana asset lokal yang telah diambil sebelumnya sudah cukup
• Capacitor aplikasi di mana <img> dan <video> tidak perlu meminta URL yang dilindungi secara langsung

Core API

• configure(options) menetapkan perilaku CDN dan revalidasi default.
• bind(element, path, options?) mengupdate elemen gambar atau video ketika file lokal sudah siap.
• src(path, options?) mengembalikan string sumber lokal untuk keadaan framework.
• resolve(path, options?) mengembalikan sumber lokal plus metadata cache.
• get(options) mengatasi URL remote ke metadata file native yang persisten.
• remove(options) menghapus satu aset cache dengan kunci atau URL.
• clear() menghapus setiap aset cache yang dikelola oleh plugin.
• list() mengembalikan aset cache yang masih ada di disk.
• getCacheSize() mengembalikan byte cache total.
• getPluginVersion() mengembalikan tanda marker implementasi native.

Model Pemvalidasi

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

Strategi	Behavior
never	Pakai file lokal ketika ada.
ttl	Re-download setelah maxAgeSeconds.
always	Revalidasi pada setiap panggilan dan kirimkan validator yang diketahui.
etag	Pakai validator HTTP ETag yang diketahui ketika ada.
last-modified	Pakai validator HTTP Last-Modified yang diketahui ketika ada.

Model Penyimpanan

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

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

Keep going from @capgo/capacitor-asset-cache

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