Panduan
Cara menggunakan Persistent UUID di Capacitor
Menggunakan @capgo/capacitor-persistent-uuid
Buat satu UUID app-scoped persisten untuk Capacitor dan pastikan tetap stabil saat reinstall maupun update, bahkan jika penyimpanan app normal dihapus.
Instal
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Apa yang Diekspos Plugin Ini
- getId - Membaca UUID yang tersimpan, dan membuatnya jika belum ada untuk scope yang dipilih.
- resetId - Mengganti UUID yang tersimpan untuk alur logout, reset privasi, atau pembersihan pengujian.
- scope - Namespace opsional untuk aplikasi yang memiliki identifier paket debug dan produksi berbeda.
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 di semua 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 melalui siklus instal ulang Android Studio dan perbedaan penandatanganan debug vs Play, selama nama paket atau scope kustom stabil. iOS menyimpan UUID di Keychain dan menjaganya tetap ada melalui pembaruan aplikasi dan iOS selama akses Keychain tetap kompatibel. Web menggunakan localStorage sebagai fallback pengembangan.
Plugin ini tidak mengekspos ID perangkat keras dan tidak bertahan melalui factory reset, penghapusan akun manual, pembersihan Keychain, pembersihan penyimpanan browser, atau resetId.
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Docs: /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 instal ulang, Perilaku iOS untuk detail Keychain, dan @capgo/capacitor-persistent-account saat Anda butuh data akun tetap tersimpan, bukan UUID.