Android 동작

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

스토리지 모델

Android에서 이 플러그인은 UUID를 플러그인이 소유한 authenticator 계정으로 AccountManager에 저장합니다. 기본 계정 이름은 앱 패키지 이름을 scope로 사용합니다.

이 덕분에 앱 전용 저장소가 삭제되는 일반적인 재설치 경로에서도 UUID가 유지됩니다. Android Studio에서 삭제/재설치를 반복하는 경우나 패키지 이름이 같을 때 서로 다른 debug 또는 Play 서명 키로 설치하는 경우가 여기에 해당합니다.

빌드 간 앱 패키지 이름이 일정하게 유지된다면 기본 scope를 사용하세요.

const result = await PersistentUuid.getId();

debug, staging, production 빌드의 패키지 식별자가 다르지만 하나의 persistent UUID를 공유해야 하는 경우, 커스텀 scope를 사용하세요.

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

사용자가 Android 설정에서 계정을 삭제하거나, 기기를 공장 초기화하거나, 패키지/scope가 변경되거나, 앱에서 resetId를 호출하면 UUID가 손실될 수 있습니다.

Android 재설치 동작을 검증하려면, 이 페이지를 다음 항목과 연결하세요: 시작하기 API 사용법, iOS 동작 Apple 플랫폼 차이점, 그리고 @capgo/capacitor-persistent-uuid 사용하기 전체 과정을 확인하려면 다음을 참고하세요.