@capgo/capacitor-penyimpanan-aset

Sumber Lokal Hanya Ditampilkan

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

Pemeliharaan penyimpanan native yang berkelanjutan

Asset yang dicache berada di penyimpanan yang berkelanjutan milik aplikasi, bukan folder cache platform yang mungkin dihapus oleh sistem di bawah tekanan.

Dukungan CDN yang dilindungi

Melewatkan header ke fetch native untuk asset yang ditandatangani atau terautentikasi sambil web element masih mengambil file lokal saja.

Pengikat yang ramah framework

Menyambung resolusi cache native ke HTML biasa, referensi React, referensi Vue, atau apapun framework yang dapat menetapkan sumber img atau video.

Ringkasan

@capgo/capacitor-asset-cache mencache gambar besar, video, dan asset CDN lainnya di penyimpanan yang berkelanjutan milik aplikasi, kemudian memberikan web app sumber URL lokal untuk tampilan.

Jalan normalnya adalah:

1. Konfigurasi URL CDN dasar sekali, atau melewatkan URL absolut per asset.
2. Panggilan AssetCache.bind(element, path) atau AssetCache.src(path).
3. Plugin ini mengambil atau memvalidasi kembali aset jarak jauh secara native.
4. Element 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(...) menolak dan bind(...) menandai element sebagai error.

Kapan Menggunakannya

Pakai Asset Cache ketika aplikasi Anda menampilkan media jarak jauh yang berat dan harus bertahan di tekanan penyimpanan normal:

• video onboarding atau video pemasaran 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 yang telah diambil sebelumnya sudah cukup
• aplikasi Capacitor di mana <img> dan <video> tidak harus mengambil URL 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 berlangsung.
• 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 total byte cache.
• getPluginVersion() mengembalikan tanda marker implementasi native.

Model Revalidasi

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

Strategi	Perilaku
never	Gunakan file lokal ketika ada.
ttl	Unduh ulang setelah maxAgeSeconds.
always	Revalidasi 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 Application Support 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 dapat dilihat sebagai media 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-cache-aset untuk merencanakan muatan media yang persisten, hubungkannya dengan Mula Menggunakan untuk detail implementasi, @capgo/capacitor-pembuat untuk download latar belakang yang eksplisit, /capgo/capacitor-file untuk akses file lokal umum, dan Menggunakan @capgo/capacitor-cache-aset untuk tutorial.