Langsung ke konten

Perilaku Android

GitHub

Di Android, plugin menyimpan UUID di AccountManager dalam akun authenticator milik plugin. Nama akun default memakai package name aplikasi sebagai scope.

Ini membuat UUID bertahan pada jalur reinstall umum yang biasanya menghapus storage privat aplikasi, termasuk siklus uninstall/reinstall di Android Studio dan instalasi dengan debug atau Play signing key berbeda selama package name tetap sama.

Gunakan scope default saat package name aplikasi stabil di semua build.

const result = await PersistentUuid.getId();

Gunakan custom scope saat build debug, staging, dan production memakai package identifier berbeda tetapi harus berbagi satu UUID persisten.

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

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

Jika Anda sedang 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.