가이드
Capacitor에서 Persistent UUID 사용 방법
@capgo/capacitor-persistent-uuid 사용하기
Capacitor를 위한 앱 전용 Persistent UUID를 생성하고, 일반 앱 저장소가 삭제되는 재설치 및 업데이트 과정에서도 안정적으로 유지하세요.
설치
npm install @capgo/capacitor-persistent-uuid
npx cap sync
플러그인이 제공하는 기능
- getId - 저장된 UUID를 읽어옵니다. 선택한 scope에 UUID가 없으면 새로 생성합니다.
- resetId - 로그아웃, 개인정보 초기화 또는 테스트 정리 흐름을 위해 저장된 UUID를 교체합니다.
- scope - 디버그와 프로덕션의 패키지 식별자가 다른 앱을 위한 선택적 네임스페이스입니다.
사용 예시
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는 UUID를 AccountManager에 저장하여, 패키지 명이나 커스텀 scope가 유지되는 한 Android Studio 재설치나 디버그/Play 서명 차이에도 UUID가 유지되도록 합니다. iOS는 UUID를 Keychain에 저장하여 Keychain 접근 권한이 유지되는 동안 앱 및 iOS 업데이트 후에도 데이터를 보존합니다. Web은 개발용 fallback으로 localStorage를 사용합니다.
이 플러그인은 하드웨어 ID를 노출하지 않으며, 공장 초기화, 수동 계정 삭제, Keychain 삭제, 브라우저 저장소 삭제 또는 resetId 호출 시에는 데이터가 유지되지 않습니다.
전체 레퍼런스
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- 문서: /docs/plugins/persistent-uuid/
계속하기
사용 중이라면 @capgo/capacitor-persistent-uuid 앱의 고유 ID를 안정적으로 유지하려면, 다음을 연결하세요: @capgo/capacitor-persistent-uuid 개요는, 시작하기 설치 및 API 예제 보기, Android 동작 방식 재설치 관련 상세 정보 iOS 동작 Keychain 상세 정보 및 @capgo/capacitor-persistent-account UUID 대신 계정 데이터 지속성이 필요할 때.