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

UUID yang Tidak Berubah

Menghasilkan dan menyimpan satu UUID aplikasi yang berlaku di seluruh reinstal, pembaruan aplikasi, dan pembaruan sistem operasi

Petunjuk

Tutorial UUID yang Tidak Berubah

Menggunakan @capgo/capacitor-uuid-yang-tidak-berubah

Buat satu UUID aplikasi yang stabil untuk Capacitor dan jaga agar tetap stabil di seluruh proses penginstalan dan pembaruan di mana penyimpanan aplikasi normal dihapus.

Pasang

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

Apa yang Dikembangkan oleh 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 alur pembersihan uji.
  • scope - Nama ruang lingkup opsional untuk aplikasi yang memiliki identifikasi paket debug dan produksi yang 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 UUID Satu untuk Variasi Build

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

Teruskan

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