Petunjuk
Tutorial UUID yang Tidak Berubah
Menggunakan @capgo/capacitor-uuid-yang-tidak-berubah
Buat satu UUID aplikasi yang stabil untuk Capacitor dan jaga stabilitasnya di seluruh proses penginstalan dan pembaruan di mana penyimpanan aplikasi normal dihapus.
Pasang
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Apa yang Dikembangkan oleh Plugin Ini
- getId - 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 - Nama ruang lingkup opsional untuk aplikasi yang memiliki identifier 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 ulang 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, pembersihan Keychain, pembersihan penyimpanan browser, atau resetId.
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-uuid-tetap/
- Dokumen: /docs/plugins/uuid-tetap/
Terus Menerus
Jika Anda menggunakan @capgo/capacitor-persistent-uuid untuk menjaga identitas aplikasi stabil, hubungkannya dengan @capgo/capacitor-persistent-uuid untuk informasi ringkasan, Mulai untuk instalasi dan contoh API Penggunaan Android untuk detail re-installasi, Penggunaan iOS untuk detail Keychain @capgo/capacitor-akun-persistent ketika Anda memerlukan data akun persistensi bukan UUID.