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