Getting Started

Copy sebuah prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-persistent-uuid`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/persistent-uuid/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Copy untuk AI

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

Impor

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

Baca atau Buat UUID

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

const result = await PersistentUuid.getId();

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

Panggilan pertama menciptakan dan menyimpan UUID. Panggilan berikutnya akan mengembalikan UUID yang sama untuk ruang lingkup yang sama.

Gunakan Ruang Lingkup Kustom yang Stabil

Default scope native adalah nama paket di Android dan identifikasi bundle di iOS. Jika bangun debug dan produksi menggunakan identifikasi paket yang berbeda tetapi harus berbagi satu UUID, kirimkan sebuah scope bersama.

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

Reset UUID

Panggil resetId ketika pengguna keluar, meminta reset privasi, atau ketika tes otomatis memerlukan identifikasi baru.

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

Harapan Penyimpanan

Android dapat bertahan setelah penghapusan dan penginstalan ulang, termasuk Android Studio dan Play instal dengan kunci tanda tangan yang berbeda, ketika nama paket atau scope kustom stabil.
iOS bertahan setelah pembaruan aplikasi dan pembaruan iOS sementara aturan akses Keychain tetap sama.
Web menggunakan localStorage dan hanya fallback pengembangan.

Lanjutkan dari Getting Started

Jika Anda menggunakan Getting Started untuk menambahkan identitas aplikasi yang persisten, hubungkannya dengan @capgo/capacitor-persistent-uuid untuk ringkasan, Tindakan Android untuk perilaku penginstalan ulang, Tindakan iOS untuk perilaku Keychain, Menggunakan @capgo/capacitor-persistent-uuid untuk tutorial, dan Direktori Plugin Capgo untuk plugin native lainnya.