Guide
How to use Persistent UUID in Capacitor
capgo에서 capacitor Persistent UUID 사용 방법
@Capacitor/__CAPGO_KEEP_1__-persistent-uuid을 사용하여
Install
npm install @capgo/capacitor-persistent-uuid
npx cap sync
설치
- 이 플러그인이 제공하는 것들입니다.
- resetId - 로그아웃, 개인 정보 초기화, 테스트 정리 흐름을 위해 저장된 UUID를 회전합니다.
- scope - debug 및 production 패키지 식별자가 다를 경우의 앱에 대한 선택적 네임스페이스입니다.
예시 사용
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
빌드 버전 간에 하나의 UUID를 공유합니다.
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
식별자 초기화
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
플랫폼 노트
Android는 패키지 이름이나 커스텀 스코프가 안정적일 때 Android Studio 재설치 주기와 debug vs Play signing 차이점을 생존합니다. iOS는 Keychain에 UUID를 저장하고 앱 및 iOS 업데이트를 통해 Keychain 접근이 호환되는 동안 생존합니다. Web은 개발용 fallback으로 localStorage를 사용합니다.
이 플러그인은 하드웨어 ID를 노출하지 않고 factory reset, 수동 계정 제거, Keychain 초기화, 브라우저 저장소 초기화, resetId를 통해 생존하지 않습니다.
전체 참조
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- 문서: /docs/plugins/persistent-uuid/
계속하기
이러한 기능을 사용 중이라면 @capgo/capacitor-persistent-uuid 앱의 고유성을 유지하기 위해 연결하세요 @capgo/capacitor-persistent-uuid 시작하기 설치 및 @__CAPGO_KEEP_0__ 예시를 위한 설명서 for install and API examples, 재설치에 대한 자세한 내용 iOS의 동작 Keychain에 대한 자세한 내용 for Keychain 세부 정보, 및 @capgo/capacitor-persistent-uuid UUID가 아닌 계정 데이터 영속성을 필요로 할 때 사용합니다.