iOS 동작

저장 모델

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

업데이트와 iOS 업데이트를 통해 살아남습니다. 또한 iOS가 Keychain 항목을 유지하고 앱이 동일한 번들 및 Apple 팀 규칙을 통해 Keychain 접근을 유지하는 한 재설치 흐름도 살아남습니다.

안정된 범위 규칙

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

const result = await PersistentUuid.getId();

다중 빌드 변형이 하나의 앱 식별자로 해결되어야 할 때 사용자 지정 범위를 사용하세요.

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

한계

UUID는 사용자가 기기를 삭제하거나, Keychain 데이터가 삭제되거나, Keychain 접근이 변경되거나, 번들/팀 접근이 변경되거나, 앱이 resetId를 호출할 때 잃어버릴 수 있습니다.

iOS 동작에서 계속하기

iOS 유효성 검증 시 연결하세요. Getting Started API 사용을 위한 시작 Android 동작 __CAPGO_KEEP_0__ 재설치 동작을 위한 Android Using @capgo/capacitor-persistent-uuid __CAPGO_KEEP_0__ 사용을 위한 전체 가이드