본문 바로가기

@capgo/capacitor-persistent-uuid

앱 재설치, 앱 업데이트, OS 업데이트 후에도 유지되는 앱 전용 UUID를 생성하고 저장하세요

앱 재설치, 앱 업데이트, OS 업데이트 후에도 유지되는 앱 전용 UUID를 생성하고 저장하세요

시작하기 getId() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.

플랫폼지원참고 사항
iOS지원네이티브
Android지원네이티브
웹아니요Capacitor.getPlatform()으로 보호하세요
  • getId - 저장된 UUID를 읽고, 선택한 scope에 없으면 새로 생성합니다.
  • resetId - 로그아웃, 계정 초기화, 개인정보 초기화, 테스트 정리 플로우에서 UUID를 교체합니다.
  • scope - 디버그와 프로덕션 빌드가 서로 다른 package identifier를 쓰지만 하나의 identifier를 공유해야 할 때는 안정적인 namespace를 사용하세요.
플랫폼스토리지기본 스코프
Android플러그인 인증자가 소유한 AccountManager 계정앱 패키지 이름
iOS키체인 일반 비밀번호, 기기 전용 접근성번들 식별자
웹localStorage 폴백환경

이것은 하드웨어 식별자가 아닙니다. 공장 초기화, 수동 계정 제거, Keychain 정리, 브라우저 저장소 정리 또는 명시적인 resetId 호출을 거치면 유지되지 않습니다.

메서드설명
getId스코프의 영구 UUID를 읽거나 생성합니다.
resetId스코프에 저장된 UUID를 교체합니다.
getPluginVersion네이티브 플러그인 버전 마커를 반환합니다.

이 레퍼런스는 src/definitions.ts에서 동기화됩니다. capacitor-persistent-uuid.

@capgo/capacitor-persistent-uuid에서 계속하기

“@capgo/capacitor-persistent-uuid에서 계속하기” 섹션

사용 중이라면 @capgo/capacitor-persistent-uuid 재설치 플로우에서 앱 설치를 식별하려면, 다음과 연결하세요: 시작하기 설치 및 사용법은 Android 동작 방식 AccountManager 세부 정보는, iOS 동작 Keychain 세부 정보는, @capgo/capacitor-persistent-uuid 사용하기 튜토리얼은, 그리고 @capgo/capacitor-persistent-account 식별자 대신 계정 데이터를 영구적으로 저장해야 할 때.