본문 바로가기

iOS 동작 방식

GitHub

iOS에서 이 플러그인은 UUID를 Keychain의 일반 비밀번호 항목으로 저장합니다. 해당 항목은 기기 전용이며, 기본 범위로 번들 식별자를 사용합니다.

앱 업데이트와 iOS 업데이트를 거치더라도 유지됩니다. iOS가 Keychain 항목을 유지하고, 앱이 동일한 번들 및 Apple 팀 규칙을 통해 호환되는 Keychain 접근을 유지하는 한 재설치 플로우에서도 유지됩니다.

번들 식별자가 안정적일 때는 기본 범위를 사용하세요.

const result = await PersistentUuid.getId();

여러 빌드 변형이 하나의 앱 식별자로 해석되도록 해야 할 때는 사용자 지정 범위를 사용하세요.

const result = await PersistentUuid.getId({ scope: 'com.example.app' });

사용자가 기기를 초기화하거나, Keychain 데이터가 삭제되거나, Keychain 접근 권한이 변경되거나, 번들/팀 접근 권한이 변경되거나, 앱이 resetId를 호출하면 UUID가 손실될 수 있습니다.

iOS 영속성을 검증 중이라면 이 페이지를 시작하기 API 사용법, Android 동작 방식 Android 재설치 동작과 함께 연결하고, @capgo/capacitor-persistent-uuid 사용하기 전체 가이드를 확인하세요.