Panduan Memulai

Salin prompt setup yang berisi langkah install 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 bisa menggunakan AI-Assisted Setup kami untuk menginstal plugin ini. Tambahkan skill Capgo ke tool AI Anda dengan command berikut:

bunx 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 memilih Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti petunjuk khusus platform di bawah ini:

bun add @capgo/capacitor-persistent-uuid
bunx cap sync

Mulai cepat

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

const result = await PersistentUuid.getId();
console.log(result);

Contoh: resetId

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

const result = await PersistentUuid.resetId();
console.log(result);

Kesalahan umum

Sinkronisasi Native: jalankan bunx cap sync setelah upgrade plugin.
Sumber kebenaran tunggal: percayai src/definitions.ts di repo GitHub.

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 membuat dan menyimpan UUID. Panggilan berikutnya mengembalikan UUID yang sama untuk scope yang sama.

Gunakan Custom Scope yang Stabil

Scope default native adalah nama package di Android dan bundle identifier di iOS. Jika build debug dan production menggunakan package identifier berbeda namun harus berbagi satu UUID yang sama, gunakan shared scope.

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

Reset UUID

Panggil resetId saat user logout, meminta reset privasi, atau saat automated test membutuhkan identifier baru.

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

Ekspektasi Persistensi

Android dapat bertahan meski di-uninstall dan di-install ulang, termasuk instalasi via Android Studio dan Play Store dengan signing key berbeda, selama package name atau custom scope tetap stabil.
iOS tetap bertahan selama update aplikasi dan update iOS selama aturan akses Keychain tidak berubah.
Web menggunakan localStorage dan hanya berfungsi sebagai fallback saat development.

Lanjutkan dari Getting Started

Jika Anda menggunakan Panduan Memulai untuk menambahkan identitas aplikasi yang persisten, hubungkan dengan @capgo/capacitor-persistent-uuid untuk ringkasan, Perilaku Android untuk perilaku instalasi ulang, Perilaku iOS untuk perilaku Keychain, Menggunakan @capgo/capacitor-persistent-uuid untuk tutorial ini, dan Direktori Plugin Capgo untuk plugin native lainnya.