Langsung ke konten utama
@capgo/capacitor-persistent-uuid Auth & Keamanan Open source

UUID Persisten plugin Capacitor

Generate dan simpan satu UUID khusus aplikasi yang bertahan setelah reinstall, update aplikasi, dan update OS

Instal

bun add @capgo/capacitor-persistent-uuid bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-persistent-uuid
  • pnpm add @capgo/capacitor-persistent-uuid
  • yarn add @capgo/capacitor-persistent-uuid

Panduan

Cara menggunakan Persistent UUID di Capacitor

Menggunakan @capgo/capacitor-persistent-uuid

Buat satu UUID app-scoped persisten untuk Capacitor dan pastikan tetap stabil saat reinstall maupun update, bahkan jika penyimpanan app normal dihapus.

Instal

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

Apa yang Diekspos Plugin Ini

  • getId - Membaca UUID yang tersimpan, dan membuatnya jika belum ada untuk scope yang dipilih.
  • resetId - Mengganti UUID yang tersimpan untuk alur logout, reset privasi, atau pembersihan pengujian.
  • scope - Namespace opsional untuk aplikasi yang memiliki identifier 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);

Gunakan satu UUID di semua varian build

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

console.log(result.id);

Reset Identifier

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

Catatan Platform

Android menyimpan UUID di AccountManager agar tetap ada melalui siklus instal ulang Android Studio dan perbedaan penandatanganan debug vs Play, selama nama paket atau scope kustom stabil. iOS menyimpan UUID di Keychain dan menjaganya tetap ada melalui pembaruan aplikasi dan iOS selama akses Keychain tetap kompatibel. Web menggunakan localStorage sebagai fallback pengembangan.

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

Referensi Lengkap

Lanjut

Jika Anda menggunakan @capgo/capacitor-persistent-uuid agar identitas aplikasi tetap stabil, hubungkan dengan @capgo/capacitor-persistent-uuid untuk ringkasan, Panduan Memulai untuk instalasi dan contoh API Perilaku Android untuk detail instal ulang, Perilaku iOS untuk detail Keychain, dan @capgo/capacitor-persistent-account saat Anda butuh data akun tetap tersimpan, bukan UUID.

FAQ

FAQ plugin Persistent UUID

Bagaimana cara menginstal plugin Persistent UUID di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-persistent-uuid" (atau "npm install @capgo/capacitor-persistent-uuid"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android memuat code native. Impor dari "@capgo/capacitor-persistent-uuid" di code aplikasi Anda.

Apakah @capgo/capacitor-persistent-uuid bekerja dengan React, Vue, dan Angular?

Ya. Persistent UUID adalah paket Capacitor, jadi bekerja dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung @capgo/capacitor-persistent-uuid?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-persistent-uuid gratis dan open source?

Ya. Sumber code bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-persistent-uuid/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan pull request sangat diterima.

Bisakah saya memperbarui code yang menggunakan Persistent UUID tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Persistent UUID tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo