빠른 시작

Unveily는 Android(7.0 이상 / API 24) 와 iOS를 동일한 기능으로 지원합니다. 아래는 Android 빠른 시작이며, iOS는 iOS 빠른 시작 섹션을 참고하세요.

AI 어시스턴트를 함께 쓰면 더 빠릅니다

아래 설정·수정 작업 대부분은 Claude, Gemini, ChatGPT 같은 AI 어시스턴트로 가속할 수 있습니다.

파일 수정: MainActivity.kt나 config.json 전체를 붙여넣고 "우리 도메인은 example.com, 사용할 기능은 QR·푸시"처럼 알려주면 수정본을 만들어 줍니다.
Bridge 코드 생성: "unveilyBridge로 QR 스캔을 열고 결과를 받는 JavaScript 코드"처럼 요청하면 예제를 생성해 줍니다.
에러 진단: 빌드·실행 에러 메시지 전체를 붙여넣으면 원인과 해결책을 알려줍니다.

생성된 결과는 반드시 이 문서와 대조해 확인하세요.

Android — 전제 조건

마이페이지 → 다운로드에서 구독 플랜에 맞는 ZIP 파일을 다운로드합니다.

unveily-android-basic-1.0.0.zip      # Basic 플랜
unveily-android-standard-1.0.0.zip   # Standard 플랜
unveily-android-pro-1.0.0.zip        # Pro 플랜

app/src/main/java/.../MainActivity.kt 에서:

// 변경 전
const val TRUSTED_WEB_URL = "https://example.com"

// 변경 후 (귀사 도메인으로 변경)
const val TRUSTED_WEB_URL = "https://your-domain.com"

마이페이지에서 발급받은 라이선스 키를 파일로 저장:

app/src/debug/assets/license.key    ← 개발 라이선스 키
app/src/release/assets/license.key ← 운영 라이선스 키

라이선스 키 파일이 없으면 앱이 시작되지 않습니다.

Firebase Console에서 프로젝트를 생성하고 google-services.json을 다운로드합니다.

app/google-services.json  ← 여기에 배치

# Debug 빌드 (개발 라이선스)
./gradlew :app:assembleBasicDebug

# Release 빌드 (운영 라이선스)
./gradlew :app:assembleBasicRelease

Release 빌드 전에 운영 라이선스 활성화를 완료하세요.

iOS SDK는 Xcode로 빌드합니다. 전체 설정은 iOS 설정 가이드를 따르며, 최소 실행 흐름은 다음과 같습니다.

다운로드한 unveily-sdk-ios-{plan} 폴더에서 Xcode 프로젝트를 생성합니다.

cd unveily-sdk-ios-pro
xcodegen generate
open *.xcodeproj

project.yml: PRODUCT_BUNDLE_IDENTIFIER, DEVELOPMENT_TEAM, UnveilyInitialURL(웹 도메인)을 자체 값으로 변경 후 xcodegen generate 재실행
UnveilyApp/Supporting/license.key: 대시보드에서 받은 라이선스 키 배치 (활성화는 Bundle ID / Team ID에 바인딩)
GoogleService-Info.plist: Firebase에서 다운로드해 .template을 교체
Info.plist: 사용하는 기능의 권한 사용 설명 키 입력 (NSCameraUsageDescription, NSFaceIDUsageDescription, NSLocationWhenInUseUsageDescription 등)
인앱결제(Pro): App Store Connect에서 상품 ID를 생성 — SDK는 StoreKit 2로 결제를 처리합니다

Xcode에서 실기기 또는 시뮬레이터를 선택하고 Product → Run으로 실행합니다. 배포는 Product → Archive → Distribute App → App Store Connect 흐름을 사용합니다.

자세한 프로젝트 구조, 소셜 로그인, entitlements 설정은 iOS 설정 가이드에 상세히 정리되어 있습니다.