Panduan
Cara menggunakan Persistent UUID di Capacitor
Menggunakan @capgo/capacitor-persistent-uuid
Generate satu UUID persistent berbasis scope aplikasi untuk Capacitor agar tetap stabil meski melalui proses reinstall atau update saat storage aplikasi biasa dihapus.
Instal
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Apa yang Diekspos Plugin Ini
- getId - Membaca UUID yang tersimpan, atau membuat baru jika belum ada untuk scope yang dipilih.
- resetId - Mengganti UUID yang tersimpan untuk alur logout, reset privasi, atau pembersihan testing.
- scope - Namespace opsional untuk aplikasi yang memiliki package identifier berbeda antara debug dan production.
Contoh Penggunaan
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
Gunakan Satu UUID untuk Berbagai Varian Build
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Reset Identifier
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Catatan Platform
Android menyimpan UUID di AccountManager agar tetap ada meski melewati siklus reinstall Android Studio atau perbedaan signing debug vs Play selama package name atau custom scope tetap stabil. iOS menyimpan UUID di Keychain dan menjaganya tetap ada melalui update aplikasi maupun iOS selama akses Keychain tetap kompatibel. Web menggunakan localStorage sebagai fallback pengembangan.
Plugin ini tidak mengekspos hardware ID dan tidak akan bertahan setelah factory reset, penghapusan akun manual, pembersihan Keychain, pembersihan storage browser, atau pemanggilan resetId.
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Dokumentasi: /docs/plugins/persistent-uuid/
Lanjut
Jika Anda menggunakan @capgo/capacitor-persistent-uuid agar identitas aplikasi tetap stabil, hubungkan dengan @capgo/capacitor-persistent-uuid untuk ringkasan, Panduan Memulai untuk instalasi dan contoh API, Perilaku Android untuk detail instalasi ulang, Perilaku iOS untuk detail Keychain, dan @capgo/capacitor-persistent-account saat Anda butuh persistensi data akun alih-alih UUID.