가이드
영구 UUID에 대한 튜토리얼
Using @capgo/capacitor-persistent-uuid
Capacitor에 대해 영구 앱 범위 UUID를 하나 생성하고 재설치 및 업데이트 흐름에서 일반 앱 저장소가 삭제되는 동안 안정적으로 유지합니다.
설치
npm install @capgo/capacitor-persistent-uuid
npx cap sync
이 플러그인이 제공하는 것
- getId - 저장된 UUID를 읽어, 선택한 범위에 대해 하나가 없으면 생성합니다.
- resetId - 로그아웃, 개인 정보 초기화, 테스트 청소 흐름에서 저장된 UUID를 회전합니다.
- scope - 앱의 디버그 및 프로덕션 패키지 식별자가 다를 때 옵션 namespace입니다.
예시 사용
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
빌드 버전 간 UUID 공유
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
식별자 초기화
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
플랫폼 참고 사항
Android는 패키지 이름이나 커스텀 스코프가 안정적일 때 Android Studio 재설치 주기 및 debug vs Play signing 차이점을 생존시킨다. iOS는 Keychain에 UUID를 저장하고 앱 및 iOS 업데이트를 통해 Keychain 접근이 호환되는 동안 유지된다. Web은 개발용으로 localStorage를 사용한다.
이 플러그인은 하드웨어 ID를 노출하지 않고 factory reset, 수동 계정 제거, Keychain 초기화, 브라우저 저장소 초기화, resetId를 생존시키지 않는다.
전체 참조
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- 문서: /docs/plugins/persistent-uuid/
계속 진행
이 플러그인을 사용하는 경우 @capgo/capacitor-persistent-uuid 앱의 고유성을 유지하기 위해 연결하세요. @capgo/capacitor-persistent-uuid 개요를 보려면 Getting Started 설치 및 API 예시를 위해 Android의 동작 재설치에 대한 자세한 내용을 위해 iOS의 동작 Keychain에 대한 자세한 내용을 위해 대신 UUID가 아닌 계정 데이터의 영구성을 필요로 할 때 @capgo/capacitor-persistent-account @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-account