Getting Started

설치

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

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를 반환합니다.

안정적인 사용자 지정 범위 사용

네이티브 기본 범위는 Android에서 패키지 이름이고 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_KEEP_0__을 사용하는 경우 Getting Started __CAPGO_KEEP_0__를 __CAPGO_KEEP_1__-persistent-uuid와 연결하여 지속적인 앱 식별성을 추가합니다. @capgo/capacitor-persistent-uuid 안드로이드 재설치 동작 재설치 동작 __CAPGO_KEEP_1__ iOS 동작 Keychain 동작을 위해 @capgo/capacitor-persistent-uuid를 사용하여 튜토리얼을 위해, Capgo 플러그인 디렉토리 다른 네이티브 플러그인에 대해