Guide
Cara Menggunakan Persistent UUID di Capacitor
Menggunakan @capgo/capacitor-uuid yang Tahan
Buat satu UUID aplikasi yang berlaku secara luas dan stabil untuk Capacitor dan jaga agar tetap stabil di sepanjang alur penginstalan dan pembaruan aplikasi di mana penyimpanan aplikasi normal dihapus.
Install
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Apa yang Dapat Diketahui oleh Plugin ini
- Mendapatkan ID - Baca UUID yang disimpan, membuat satu jika tidak ada untuk ruang lingkup yang dipilih.
- resetId - Rotasi UUID yang disimpan untuk logout, reset privasi, atau alur pembersihan uji coba.
- scope - Namespace opsional untuk aplikasi yang memiliki identifikasi paket debug dan produksi yang 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);
Bagikan UUID Satu untuk Variasi Bangun
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Reset Identifikasi
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Catatan Platform
Android menyimpan UUID di AccountManager sehingga dapat bertahan melalui siklus penginstalan Android Studio dan perbedaan tanda tangan debug vs Play ketika nama paket atau ruang lingkup kustom stabil. iOS menyimpan UUID di Keychain dan menjaganya melalui update aplikasi dan iOS sementara akses Keychain tetap kompatibel. Web menggunakan localStorage sebagai fallback pengembangan.
Plugin ini tidak mengekspos ID perangkat keras dan tidak bertahan melalui reset pabrik, penghapusan akun manual, membersihkan Keychain, membersihkan penyimpanan browser, atau resetId.
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-uuid-persistent/
- Dokumen: /docs/plugins/uuid-persistent/
Terus Menerus
Jika Anda menggunakan @capgo/capacitor-persistent-uuid untuk menjaga identitas aplikasi stabil, hubungkannya dengan @capgo/capacitor-persistent-uuid untuk informasi ringkasan, Panduan Awal untuk instalasi dan API contoh, Perilaku Android untuk detail re-installasi, Perilaku iOS untuk detail Keychain, dan @capgo/capacitor-akun-persistent ketika Anda membutuhkan data akun persistensi bukan UUID.