본문 바로가기
@capgo/capacitor-persistent-uuid 인증 및 보안 오픈 소스

영구 UUID Capacitor 플러그인

앱 재설치, 앱 업데이트, OS 업데이트 후에도 유지되는 앱 전용 UUID를 생성하고 저장하세요

설치

bun add @capgo/capacitor-persistent-uuid bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-persistent-uuid
  • pnpm add @capgo/capacitor-persistent-uuid
  • yarn add @capgo/capacitor-persistent-uuid

가이드

Capacitor에서 Persistent UUID 사용법

@capgo/capacitor-persistent-uuid 사용하기

Capacitor용 앱 스코프 Persistent UUID를 하나 생성하고, 일반 앱 스토리지가 제거되는 재설치 및 업데이트 플로우에서도 안정적으로 유지하세요.

설치

npm install @capgo/capacitor-persistent-uuid
npx cap sync

플러그인이 제공하는 기능

  • getId - 저장된 UUID를 읽고, 선택한 scope에 없으면 새로 생성합니다.
  • resetId - 로그아웃, 개인정보 초기화 또는 테스트 정리 플로우를 위해 저장된 UUID를 회전(Rotate)합니다.
  • scope - 디버그와 프로덕션 패키지 식별자가 다른 앱에 선택적으로 사용할 네임스페이스입니다.

사용 예시

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는 AccountManager에 UUID를 저장하여 패키지 이름이나 커스텀 scope가 안정적일 때 Android Studio 재설치 사이클 및 디버그/Play 서명 차이에도 유지됩니다. iOS는 Keychain에 UUID를 저장하여 Keychain 접근이 호환되는 동안 앱 및 iOS 업데이트를 통해 유지됩니다. Web은 개발용 폴백으로 localStorage를 사용합니다.

이 플러그인은 하드웨어 ID를 노출하지 않으며, 공장 초기화, 수동 계정 제거, Keychain 초기화, 브라우저 저장소 초기화 또는 resetId 호출 시 UUID가 유지되지 않습니다.

전체 레퍼런스

계속하기

사용 중이라면 @capgo/capacitor-persistent-uuid 앱 식별자를 안정적으로 유지하려면, 다음 항목과 연결하세요: @capgo/capacitor-persistent-uuid 개요는, 시작하기 설치 및 API 예제 보기, Android 동작 방식 재설치 관련 상세 정보, iOS 동작 Keychain 상세 정보 및 @capgo/capacitor-persistent-account UUID 대신 계정 데이터 지속성이 필요할 때.

자주 묻는 질문

Persistent UUID 플러그인 FAQ

Capacitor 앱에 Persistent UUID 플러그인을 어떻게 설치하나요?

"bun add @capgo/capacitor-persistent-uuid"(또는 "npm install @capgo/capacitor-persistent-uuid")를 실행한 뒤 "bunx cap sync"를 실행해 iOS와 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 앱 code에서 "@capgo/capacitor-persistent-uuid"에서 import 하면 됩니다.

@capgo/capacitor-persistent-uuid는 React, Vue, Angular와 호환되나요?

네. Persistent UUID는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte, 일반 JavaScript 등 Capacitor에서 실행되는 모든 웹 프레임워크와 호환됩니다.

@capgo/capacitor-persistent-uuid은 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-persistent-uuid는 무료 오픈 소스인가요?

네. 소스 code는 GitHub의 https://github.com/Cap-go/capacitor-persistent-uuid/에서 공개되어 있으며, 패키지는 npm에서 무료로 설치할 수 있습니다. 버그 리포트와 풀 리퀘스트는 언제나 환영합니다.

Persistent UUID를 사용하는 code를 App Store 심사 없이 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 심사 대기 없이 Persistent UUID 변경 사항을 즉시 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기