@capgo/capacitor-persistent-uuid

개요

앱 재설치, 앱 업데이트 및 OS 업데이트 시에도 유지되는 앱 전용 UUID 생성 및 저장

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

플랫폼 지원

플랫폼	지원	참고 사항
iOS	지원	네이티브
Android	지원	네이티브
웹	아니요	Capacitor.getPlatform()으로 보호하세요

핵심 기능

• getId - 저장된 UUID를 읽어옵니다. 선택한 scope에 UUID가 없는 경우 새로 생성합니다.
• resetId - 로그아웃, 계정 초기화, 개인정보 초기화 또는 테스트 정리 흐름에서 UUID를 교체합니다.
• scope - 디버그와 프로덕션 빌드의 패키지 식별자가 다르더라도 동일한 식별자를 공유해야 하는 경우 안정적인 네임스페이스로 사용합니다.

플랫폼 스토리지

플랫폼	스토리지	기본 스코프
Android	플러그인 인증인이 소유한 AccountManager 계정	앱 패키지 이름
iOS	Keychain generic password, 기기 전용 접근 권한	Bundle identifier
웹	localStorage 폴백	환경

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

공개 API

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

Source of Truth

이 레퍼런스는 다음 경로의 src/definitions.ts에서 동기화되었습니다: capacitor-persistent-uuid.

@capgo/capacitor-persistent-uuid 더 알아보기

사용 중이라면 @capgo/capacitor-persistent-uuid 앱 재설치 시에도 동일한 설치 기기를 식별하려면, 다음을 연결하세요: 시작하기 설치 및 사용법은 Android 동작 방식 AccountManager 상세 정보는, iOS 동작 Keychain 상세 정보는, @capgo/capacitor-persistent-uuid 사용하기 튜토리얼은 다음을, @capgo/capacitor-persistent-account 식별자 대신 계정 데이터를 유지해야 할 때