Mulai Menggunakan

Copas 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.

Instal

Anda dapat menggunakan Setup Bantuan AI kami untuk menginstal plugin. Tambahkan Capgo kemampuan ke alat AI Anda menggunakan perintah berikut:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Lalu gunakan prompt berikut:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-persistent-uuid` plugin in my project.

Jika Anda lebih suka Setup Manual, instal plugin dengan menjalankan perintah-perintah berikut dan ikuti instruksi spesifik platform di bawah ini:

bun add @capgo/capacitor-persistent-uuid
bunx 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 kemudian kembali mengembalikan UUID yang sama untuk ruang lingkup yang sama.

Pakai Ruang Lingkup Kustom yang Stabil

Ruang lingkup default native adalah nama paket pada Android dan identifikasi paket pada iOS. Jika bangun debug dan produksi menggunakan identifikasi paket yang berbeda tetapi harus berbagi satu UUID, masukkan ruang lingkup bersama.

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

Atur Ulang UUID

Panggil resetId ketika pengguna keluar dari akun, meminta reset privasi, atau ketika tes otomatis memerlukan identifier baru.

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

Harapan Penyimpanan

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

Lanjutkan dari Getting Started

Jika Anda menggunakan Mulai Menggunakan to add persistent app identity, connect it with @capgo/capacitor-uuid Persisten untuk ringkasan, tingkah laku Android untuk perilaku penginstalan ulang, perilaku iOS untuk perilaku Keychain, Menggunakan @capgo/capacitor-persistent-uuid untuk tutorial, dan Capgo Direktori Plugin untuk plugin native lainnya.