Android Release Build Skill

Google Play Store 배포를 위한 Android App Bundle(AAB) 프로덕션 빌드를 생성하는 스킬입니다.

빌드 전 체크리스트

필수 확인 사항

• Keystore 파일 준비 완료
• gradle.properties에 서명 정보 설정
• versionCode 증가 확인
• versionName 업데이트 확인
• ProGuard/R8 규칙 설정
• 디버그 코드 제거 (Log, debuggable 등)

build.gradle.kts 릴리즈 설정 확인

android {
    defaultConfig {
        versionCode = 10
        versionName = "1.2.0"
    }

    buildTypes {
        release {
            isMinifyEnabled = true
            isShrinkResources = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
            signingConfig = signingConfigs.getByName("release")
        }
    }
}

AAB 빌드 명령어

기본 릴리즈 빌드

./gradlew bundleRelease

클린 빌드 (권장)

./gradlew clean bundleRelease

빌드 + 테스트

./gradlew clean test bundleRelease

특정 flavor 빌드

# productFlavors가 있는 경우
./gradlew bundleProductionRelease
./gradlew bundleFreeRelease
./gradlew bundlePaidRelease

빌드 출력 경로

app/build/outputs/bundle/release/app-release.aab

빌드 최적화 옵션

병렬 빌드

./gradlew bundleRelease --parallel

빌드 캐시 사용

./gradlew bundleRelease --build-cache

메모리 설정 (gradle.properties)

org.gradle.jvmargs=-Xmx4g -XX:+HeapDumpOnOutOfMemoryError
org.gradle.parallel=true
org.gradle.caching=true

AAB 검증

bundletool로 APK 추출 테스트

# bundletool 설치 (macOS)
brew install bundletool

# APK 세트 생성
bundletool build-apks \
  --bundle=app/build/outputs/bundle/release/app-release.aab \
  --output=app-release.apks \
  --ks=keystore/release-key.jks \
  --ks-key-alias=my-key-alias \
  --ks-pass=pass:<password>

# 연결된 디바이스에 설치
bundletool install-apks --apks=app-release.apks

AAB 정보 확인

bundletool dump manifest --bundle=app-release.aab
bundletool dump resources --bundle=app-release.aab

앱 크기 분석

bundletool get-size total --bundle=app-release.aab

Play Console 업로드

Google Play Console CLI (추천)

# 설치
pip install google-play-scraper

# 또는 Gradle Play Publisher 플러그인 사용
./gradlew publishReleaseBundle

Gradle Play Publisher 설정

// build.gradle.kts
plugins {
    id("com.github.triplet.play") version "3.8.4"
}

play {
    serviceAccountCredentials.set(file("play-service-account.json"))
    track.set("internal") // internal, alpha, beta, production
    defaultToAppBundles.set(true)
}

멀티 모듈 프로젝트

전체 모듈 빌드

./gradlew :app:bundleRelease

Dynamic Feature Module 포함

./gradlew :app:bundleRelease \
  :feature1:bundleRelease \
  :feature2:bundleRelease

문제 해결

일반적인 빌드 오류

ProGuard/R8 디버깅

# 매핑 파일 생성 확인
ls app/build/outputs/mapping/release/

# 규칙 테스트
./gradlew :app:minifyReleaseWithR8 --info

리소스 축소 문제

// 특정 리소스 유지
android {
    buildTypes {
        release {
            // res/raw/keep.xml 사용
        }
    }
}

<!-- res/raw/keep.xml -->
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@layout/some_layout,@drawable/some_image" />

CI/CD 빌드 스크립트

GitHub Actions 예시

- name: Build Release AAB
  run: |
    echo "${{ secrets.KEYSTORE_BASE64 }}" | base64 -d > keystore.jks
    ./gradlew bundleRelease
  env:
    RELEASE_STORE_FILE: keystore.jks
    RELEASE_STORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
    RELEASE_KEY_ALIAS: ${{ secrets.KEY_ALIAS }}
    RELEASE_KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}

빌드 완료 후

1. AAB 파일 확인: app/build/outputs/bundle/release/app-release.aab
2. 매핑 파일 백업: app/build/outputs/mapping/release/mapping.txt
3. Play Console 업로드
4. 내부 테스트 트랙에서 먼저 테스트
5. 단계적 출시 (Staged Rollout) 권장

사용 예시

사용자가 다음과 같이 요청하면 이 스킬을 활용합니다:

• “AAB 빌드해줘”
• “릴리즈 빌드 만들어줘”
• “프로덕션 빌드해줘”
• “Play Store용 빌드해줘”
• “번들 빌드해줘”
• “배포용 빌드 생성해줘”