Lompat ke konten utama
Kembali ke plugin
@capgo/capacitor-persistent-uuid
Tutorial
@capgo/capacitor-persistent-uuid

UUID Tahan

Menghasilkan dan menyimpan satu UUID aplikasi yang berlaku di reinstal, pembaruan aplikasi, dan pembaruan OS

Petunjuk

Tutorial tentang UUID yang Tidak Berubah

Menggunakan @capgo/capacitor-persistent-uuid

Generate one persistent app-scoped UUID for Capacitor and keep it stable across reinstall and update flows where normal app storage is removed.

Pasang

npm install @capgo/capacitor-persistent-uuid
npx cap sync

Apa yang Dapat Dilihat dari Plugin Ini

  • getId - Baca UUID yang Disimpan, Membuat Satu jika Tidak Ada untuk Ruang Lingkup yang Dipilih.
  • resetId - Rotasi UUID yang Disimpan untuk Logout, Reset Privasi, atau Pembersihan Uji Coba.
  • scope - Nama Ruang Lingkup Opsional untuk Aplikasi yang Identifikasi Paket Debug dan Produksi Berbeda.

Contoh Penggunaan

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const { id, created, scope } = await PersistentUuid.getId();

console.log(id);
console.log(created);
console.log(scope);

Bagikan Satu UUID di Seluruh Variasi Pembangunan

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

console.log(result.id);

Reset Identifikasi

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

Catatan Platform

Android menyimpan UUID di AccountManager sehingga dapat bertahan melalui siklus penginstalan ulang Android Studio dan perbedaan tanda tangan debug vs Play ketika nama paket atau ruang lingkup kustom stabil. iOS menyimpan UUID di Keychain dan menjaganya melalui aplikasi dan pembaruan iOS sementara akses Keychain tetap kompatibel. Web menggunakan localStorage sebagai fallback pengembangan.

Plugin ini tidak mengekspos ID perangkat keras dan tidak bertahan melalui reset pabrik, penghapusan akun manual, pembersihan Keychain, pembersihan penyimpanan browser, atau resetId.

Referensi Lengkap

Jika Anda menggunakan

__CAPGO_KEEP_0__ @capgo/capacitor-persistent-uuid untuk menjaga identitas aplikasi stabil, hubungkan dengan @capgo/capacitor-persistent-uuid untuk ringkasan, Getting Started untuk instalasi dan API contoh, Tindakan Android untuk detail re-installasi, Tindakan iOS untuk detail Keychain, dan @capgo/capacitor-persistent-account ketika Anda memerlukan persistensi data akun daripada UUID.