Penggunaan Android

Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

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 di mana penyimpanan aplikasi pribadi akan dihapus, 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 Stabil

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

const result = await PersistentUuid.getId();

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

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

Batasan

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

Lanjutkan dari perilaku Android

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