@capgo/capacitor-asset-cache

__CAPGO_KEEP_0__

src, resolveTampilkan sumber lokal saja bind mengembalikan sumber daya hanya setelah file lokal ada. Tag img atau video Anda menerima URL webview lokal.

Penggunaan Penyimpanan Nama Lokal yang Tidak Terhapus

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

Dukungan CDN yang Dilindungi

Melewatkan kepala ke fetch native untuk aset yang ditandatangani atau terautentikasi sambil elemen web masih hanya memuat file lokal.

Pengikat yang Ramah Framework

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

Ringkasan

@capgo/capacitor-asset-cache mengganti gambar besar, video, dan aset CDN lainnya ke 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 lewatkan 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 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 aset lokal sebelumnya yang cukup
• aplikasi Capacitor di mana <img> dan <video> tidak harus 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 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-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	Sikap
never	Gunakan file lokal ketika ada.
ttl	Unduh ulang setelah maxAgeSeconds.
always	Validasi ulang pada setiap panggilan dan kirimkan validator yang diketahui.
etag	Gunakan validator HTTP ETag yang diketahui ketika ada.
last-modified	Gunakan 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().

Teruskan dari @capgo/capacitor-asset-cache

Jika Anda menggunakan @capgo/capacitor-asset-cache untuk merencanakan muatan media yang persisten, hubungkan dengan Panduan Awal 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.