iOS 동작 방식
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
스토리지 모델
“스토리지 모델” 섹션iOS에서 이 플러그인은 UUID를 Keychain의 일반 비밀번호 항목으로 저장합니다. 해당 항목은 기기 전용이며, 기본 범위로 번들 식별자를 사용합니다.
앱 업데이트와 iOS 업데이트를 거치더라도 유지됩니다. iOS가 Keychain 항목을 유지하고, 앱이 동일한 번들 및 Apple 팀 규칙을 통해 호환되는 Keychain 접근을 유지하는 한 재설치 플로우에서도 유지됩니다.
Stable Scope 규칙
“Stable Scope 규칙” 섹션번들 식별자가 안정적일 때는 기본 범위를 사용하세요.
const result = await PersistentUuid.getId();여러 빌드 변형이 하나의 앱 식별자로 해석되도록 해야 할 때는 사용자 지정 범위를 사용하세요.
const result = await PersistentUuid.getId({ scope: 'com.example.app' });제한 사항
“제한 사항” 섹션사용자가 기기를 초기화하거나, Keychain 데이터가 삭제되거나, Keychain 접근 권한이 변경되거나, 번들/팀 접근 권한이 변경되거나, 앱이 resetId를 호출하면 UUID가 손실될 수 있습니다.
iOS 동작에서 계속
“iOS 동작 방식에서 계속하기” 섹션iOS 영속성을 검증 중이라면 이 페이지를 시작하기 API 사용법, Android 동작 방식 Android 재설치 동작과 함께 연결하고, @capgo/capacitor-persistent-uuid 사용하기 전체 가이드를 확인하세요.