Langkah ke konten utama
@capgo/capacitor-uuid-tahanan Autentikasi & Keamanan Terbuka Sumber

UUID Tahanan Plugin Capacitor

Menghasilkan dan menyimpan satu UUID aplikasi yang berlaku di antara penginstalan ulang, pembaruan aplikasi, dan pembaruan sistem

Install

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

Guide

Cara Menggunakan Persistent UUID di Capacitor

Menggunakan @capgo/capacitor-uuid yang Tahan

Buat satu UUID aplikasi yang berlaku secara luas dan stabil untuk Capacitor dan jaga agar tetap stabil di sepanjang alur penginstalan dan pembaruan aplikasi di mana penyimpanan aplikasi normal dihapus.

Install

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

Apa yang Dapat Diketahui oleh Plugin ini

  • Mendapatkan ID - 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 coba.
  • scope - Namespace 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 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 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 update aplikasi dan 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, membersihkan Keychain, membersihkan penyimpanan browser, atau resetId.

Referensi Lengkap

Terus Menerus

Jika Anda menggunakan @capgo/capacitor-persistent-uuid untuk menjaga identitas aplikasi stabil, hubungkannya dengan @capgo/capacitor-persistent-uuid untuk informasi ringkasan, Panduan Awal untuk instalasi dan API contoh, Perilaku Android untuk detail re-installasi, Perilaku iOS untuk detail Keychain, dan @capgo/capacitor-akun-persistent ketika Anda membutuhkan data akun persistensi bukan UUID.

FAQ

FAQ Plugin UUID Tahanan

Bagaimana cara saya menginstal plugin UUID Persistent di aplikasi Capacitor?

Run "bun add @capgo/capacitor-persistent-uuid" (or "npm install @capgo/capacitor-persistent-uuid"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-persistent-uuid" in your app code.

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

Yes. Persistent UUID is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Apa versi Capacitor yang didukung oleh @capgo/capacitor-persistent-uuid?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Apakah @capgo/capacitor-persistent-uuid gratis dan terbuka sumber?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-persistent-uuid/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Bisa saya update code yang menggunakan Persistent UUID tanpa melalui tinjauan App Store?

Instalasi atau mengupgrade plugin mengubah native code, sehingga memerlukan pembangunan toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat berlayar secara instan dengan Capgo pembaruan hidup.

Kirim perubahan UUID Persistent tanpa menunggu tinjauan aplikasi

Saat plugin sudah ada di dalam build toko Anda, Capgo pembaruan hidup memasukkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo