시작하기

설치

플러그인을 설치하기 위해 AI-Assisted Setup을 사용할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

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

그다음에 다음 프롬프트를 사용하세요:

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

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

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

수입

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

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);

첫 번째 호출은 UUID를 생성하고 저장합니다. 이후 호출은 동일한 범위에 대해 동일한 UUID를 반환합니다.

안정적인 커스텀 범위 사용

네이티브 기본 범위는 안드로이드에서는 패키지 이름이고 iOS에서는 번들 식별자입니다. debug 및 production 빌드가 서로 다른 패키지 식별자를 사용하지만 하나의 UUID를 공유해야 하는 경우 공유 범위를 전달하세요.

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

UUID를 초기화하세요

사용자가 로그아웃하거나 개인 정보 초기화를 요청하거나 자동화된 테스트에서 새로운 식별자가 필요할 때 resetId를 호출하세요.

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

지속성 기대

• 안드로이드는 패키지 이름 또는 커스텀 범위가 안정적일 때, Android Studio와 Play 설치와 다른 서명 키를 사용하는 경우에도 제거 및 재설치가 가능합니다.
• iOS는 앱 업데이트와 iOS 업데이트를 포함하여 Keychain 접근 규칙이 동일한 경우에 살아남습니다.
• 웹은 localStorage를 사용하고 개발용으로만 fallback입니다.

Getting Started에서 계속하세요

이미 사용 중이라면 시작하기 영구적 앱 식별성을 추가하기 위해 연결하세요. @capgo/capacitor-persistent-uuid 개요를 보려면 Android 동작 재설치 동작 iOS 동작 Keychain 동작 @capgo/capacitor-persistent-uuid 사용 튜토리얼을 보려면 Capgo 플러그인 디렉토리 다른 네이티브 플러그인