첫 번째 빌드

이 문서는 Android(Android Studio / Gradle) 빌드를 다룹니다. iOS 빌드는 아래 iOS 빌드 섹션과 iOS 설정 가이드를 참고하세요. Android는 7.0 이상(API 24), iOS와 동일한 기능을 지원합니다.

빌드 유형

Debug 빌드 (개발용)

# Basic 플랜 Debug 빌드
./gradlew :app:assembleBasicDebug

# Standard 플랜
./gradlew :app:assembleStandardDebug

# Pro 플랜
./gradlew :app:assembleProDebug

Release 빌드 (배포용)

# 서명 키스토어 설정 후
./gradlew :app:assembleBasicRelease

app/build.gradle.kts에 서명 설정:

android {
    signingConfigs {
        create("release") {
            storeFile = file(System.getenv("KEYSTORE_PATH") ?: "release.jks")
            storePassword = System.getenv("KEYSTORE_PASSWORD") ?: ""
            keyAlias = System.getenv("KEY_ALIAS") ?: ""
            keyPassword = System.getenv("KEY_PASSWORD") ?: ""
        }
    }
    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
            isMinifyEnabled = true
            isShrinkResources = true
        }
    }
}

빌드 에러가 나면 AI에게 물어보세요

Gradle나 Xcode 빌드 에러는 에러 로그 전체를 그대로 AI 어시스턴트(Claude·Gemini·ChatGPT)에 붙여넣고 "이 에러의 원인과 해결법"을 물어보면 대부분 빠르게 해결됩니다. 라이선스 키·서명 설정 관련 에러라면 운영 배포 체크리스트와 대조하세요.

완료 전 점검

빌드 전 아래 항목을 모두 확인하세요:

TRUSTED_WEB_URL 변경 완료
app/src/debug/assets/license.key 생성
app/google-services.json 배치
(릴리즈만) app/src/release/assets/license.key 생성
(릴리즈만) 운영 라이선스 활성화 완료

iOS 빌드 (Xcode)

iOS SDK는 Xcode로 빌드합니다. 상세한 프로젝트 설정은 iOS 설정 가이드를 따르고, 빌드·배포는 아래 흐름을 사용합니다.

xcodegen generate 로 Xcode 프로젝트를 생성한 뒤 .xcodeproj를 엽니다.
개발 중에는 실기기 또는 시뮬레이터를 선택하고 Product → Run으로 실행합니다.
배포 시에는 실기기용 타깃을 선택하고 Product → Archive를 실행합니다.
Organizer 창에서 Distribute App → App Store Connect로 업로드합니다.

iOS는 라이선스 키를 앱 번들의 UnveilyApp/Supporting/license.key에 배치하며, 활성화는 Bundle ID / Team ID에 바인딩됩니다. 자세한 내용은 iOS 설정 가이드를 참고하세요.