Langsung ke konten

Perilaku iOS

GitHub

Di iOS, plugin menyimpan UUID di Keychain sebagai item password generik. Item ini bersifat khusus perangkat dan menggunakan bundle identifier sebagai scope default.

Data ini tetap aman saat update aplikasi maupun iOS. Data juga tetap ada saat instal ulang selama iOS menyimpan item Keychain tersebut dan aplikasi tetap memiliki akses Keychain yang kompatibel melalui bundle dan aturan Apple team yang sama.

Gunakan scope default jika bundle identifier bersifat stabil.

const result = await PersistentUuid.getId();

Gunakan scope kustom jika beberapa varian build harus merujuk ke satu app identifier.

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

UUID dapat hilang jika pengguna menghapus perangkat, data Keychain dihapus, akses Keychain berubah, akses bundle/team berubah, atau aplikasi memanggil resetId.

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