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.
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-pluginsLalu 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-uuidbunx cap syncMulai cepat
Bagian berjudul “Mulai cepat”import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const result = await PersistentUuid.getId();console.log(result);Contoh: resetId
Bagian berjudul “Contoh: resetId”import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const result = await PersistentUuid.resetId();console.log(result);Kesalahan umum
Bagian berjudul “Kesalahan umum”- Sinkronisasi Native: jalankan
bunx cap syncsetelah upgrade plugin. - Sumber kebenaran tunggal: percayai
src/definitions.tsdi repo GitHub.
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';Baca atau Buat UUID
Bagian berjudul “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
Bagian berjudul “Gunakan Custom Scope yang Stabil”Scope default native adalah nama package di Android dan bundle identifier di iOS. Jika build debug dan produksi menggunakan identifier package yang berbeda tetapi harus berbagi satu UUID, gunakan scope bersama.
const result = await PersistentUuid.getId({ scope: 'com.example.app',});Reset UUID
Bagian berjudul “Reset UUID”Panggil resetId saat user logout, meminta reset privasi, atau saat automated tests membutuhkan identifier baru.
const replacement = await PersistentUuid.resetId();console.log(replacement.id);Ekspektasi Persistensi
Bagian berjudul “Ekspektasi Persistensi”- Android dapat bertahan dari uninstall dan reinstall, termasuk instalasi Android Studio dan Play dengan signing key yang berbeda, selama nama package atau custom scope tetap stabil.
- iOS tetap bertahan melalui pembaruan aplikasi dan pembaruan iOS, selama aturan akses Keychain tidak berubah.
- Web menggunakan localStorage dan hanya berfungsi sebagai fallback untuk pengembangan.
Lanjutkan dari Getting Started
Bagian berjudul “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 saat instal ulang, Perilaku iOS untuk perilaku Keychain, Menggunakan @capgo/capacitor-persistent-uuid untuk tutorialnya, dan Direktori Plugin Capgo untuk plugin native lainnya.