Perilaku Android

Model Penyimpanan

Pada Android, plugin menyimpan UUID di AccountManager di bawah akun autentikator plugin yang dimiliki. Nama akun default menggunakan nama paket aplikasi sebagai ruang lingkup.

Hal ini memungkinkan UUID bertahan di jalur penginstalan umum yang menghapus penyimpanan pribadi aplikasi, termasuk siklus penginstalan ulang Android Studio dan instalasi yang ditandatangani dengan kunci debug atau Play yang berbeda ketika nama paket tetap sama.

Aturan Ruang Lingkup yang Stabil

Gunakan ruang lingkup default ketika nama paket aplikasi stabil di antara build.

const result = await PersistentUuid.getId();

Gunakan ruang lingkup khusus ketika build debug, staging, dan produksi menggunakan identifier paket yang berbeda tetapi harus berbagi satu UUID yang persisten.

const result = await PersistentUuid.getId({ scope: 'com.example.app' });

Pengaturan Batas

UUID dapat hilang jika pengguna menghapus akun dari pengaturan Android, perangkat direset ke pabrik, paket/ruang lingkup berubah, atau aplikasi memanggil resetId.

Teruskan dari perilaku Android

Jika Anda memvalidasi perilaku penginstalan ulang Android, hubungkan halaman ini dengan Panduan Awal untuk API penggunaan, perilaku iOS untuk perbedaan platform Apple, dan Menggunakan @capgo/capacitor-persistent-uuid untuk walkthrough yang lengkap.