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

UUID Tahan

Generasi dan menyimpan satu UUID aplikasi-skop yang berlaku di setiap ulang instalasi, pembaruan aplikasi, dan pembaruan OS

Panduan

Tutorial tentang UUID yang Tahan

Menggunakan @capgo/capacitor-persistent-uuid

Generasi satu UUID aplikasi-skop yang tahan di Capacitor dan jaga stabilitasnya di setiap ulang instalasi dan alur pembaruan di mana penyimpanan aplikasi normal dihapus.

Pasang

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

What Plugin Ini Menyediakan

  • getId - Baca UUID yang disimpan, membuat satu jika tidak ada untuk skop yang dipilih.
  • resetId - Rotasi UUID yang disimpan untuk logout, reset privasi, atau alur pembersihan tes.
  • scope - Nama ruang lingkup opsional untuk aplikasi yang memiliki identifikasi paket debug dan produksi yang berbeda.

Penggunaan Contoh

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 Variasi Bangun

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 signing debug vs Play ketika nama paket atau ruang lingkup kustom stabil. iOS menyimpan UUID di Keychain dan menjaganya melalui aplikasi dan update iOS sementara akses Keychain tetap kompatibel. Web menggunakan localStorage sebagai fallback pengembangan.

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

Referensi Lengkap

Terus Menerus

Jika Anda menggunakan @capgo/capacitor-persistent-uuid untuk menjaga identitas aplikasi stabil, hubungkan dengan @capgo/capacitor-persistent-uuid untuk ringkasan, Mengawali Langkah untuk instalasi dan contoh API, Tindakan Android untuk detail re-installasi, Sikap iOS untuk detail Keychain, dan @capgo/capacitor-akun-persistent ketika Anda membutuhkan persistensi data akun daripada UUID.