Perilaku Android

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

Model Penyimpanan

Di Android, plugin ini menyimpan UUID di AccountManager di bawah akun authenticator milik plugin. Nama akun default menggunakan package name aplikasi sebagai scope.

Ini memungkinkan UUID tetap ada meskipun aplikasi diinstal ulang, di mana penyimpanan privat aplikasi biasanya akan dihapus, termasuk siklus uninstall/reinstall di Android Studio dan instalasi dengan debug atau Play signing key yang berbeda selama package name tetap sama.

Aturan Scope Stabil

Gunakan scope default jika package name aplikasi stabil di berbagai build.

const result = await PersistentUuid.getId();

Gunakan custom scope jika build debug, staging, dan production menggunakan package identifier berbeda namun harus berbagi satu UUID persisten yang sama.

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

Batasan

UUID dapat hilang jika pengguna menghapus akun dari pengaturan Android, perangkat di-factory reset, package/scope berubah, atau aplikasi memanggil resetId.

Lanjutkan ke Android Behavior

Jika Anda memvalidasi perilaku instalasi ulang Android, hubungkan halaman ini dengan Panduan Memulai untuk penggunaan API, Perilaku iOS untuk perbedaan platform Apple, dan Menggunakan @capgo/capacitor-persistent-uuid untuk panduan lengkapnya.