Android Academy · 강의

릴리스 빌드 준비

앱 번들과 크기 축소를 알아봅니다.

릴리스 빌드 준비은(는) CoddyKit의 무료 Android Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Android Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

디버그에서 출시까지

매일 Android Studio에서 디버그 빌드를 실행합니다. 하지만 Google Play에는 더 작고 빠르며 디버깅 가능으로 표시되지 않는 출시 빌드가 필요합니다.

출시 빌드는 세 가지 핵심적인 차이가 있습니다. 출시 키로 서명되고, debuggable false로 설정되며, 일반적으로 사용하지 않는 코드와 리소스를 제거하도록 축소됩니다.

이 학습에서는 올바른 출시 빌드를 준비하고 Google Play가 요구하는 파일인 Android App Bundle(.aab)을 생성합니다.

Gradle의 빌드 유형

Gradle은 기본적으로 debug와 release라는 두 가지 빌드 유형을 정의합니다. 모듈의 build.gradle.kts에서 이를 구성합니다.

release 블록에서 최적화를 활성화합니다. 아래의 isMinifyEnabled와 isShrinkResources에 주목하십시오. 이 설정들이 앱을 더 작게 만드는 스위치입니다.

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

AAB와 APK 비교

Google Play는 일반적인 .apk가 아니라 Android App Bundle(.aab)을 요구합니다.

.apk에는 모든 기기를 위한 코드와 리소스가 들어 있습니다. 모든 화면 밀도, 모든 CPU 아키텍처, 모든 언어가 포함됩니다.
.aab를 Play에 업로드하면 Play가 각 사용자의 정확한 기기에 맞는 작고 최적화된 APK를 생성합니다.

그 결과 사용자는 더 적은 양을 다운로드하고 앱도 더 작은 크기로 설치됩니다. 휴대전화에서 직접 테스트할 때는 여전히 APK를 사용하지만, 배포할 때는 AAB를 사용합니다.

R8 및 축소란

isMinifyEnabled = true이면 Android Studio가 R8을 실행합니다. R8은 한 번의 처리로 세 가지 작업을 수행합니다.

축소 — 앱이 호출하지 않는 클래스와 메서드를 제거합니다.
난독화 — 공간을 절약하고 역공학을 어렵게 만들기 위해 클래스와 메서드의 이름을 a, b, c 같은 짧은 이름으로 바꿉니다.
최적화 — 코드를 인라인화하고 다시 작성해 더 빠르게 실행합니다.

리소스 축소(isShrinkResources = true)는 사용하지 않는 드로어블, 레이아웃, 문자열도 추가로 제거합니다.

ProGuard의 유지 규칙

R8은 Gson, Retrofit 또는 직렬화처럼 리플렉션으로만 참조되는 코드를 삭제하거나 이름을 바꾸는 경우가 있습니다. 이러한 코드는 proguard-rules.pro의 유지 규칙으로 보호합니다.

유지 규칙은 R8에 다음과 같이 지시합니다. "이 클래스들의 이름을 바꾸거나 삭제하지 마세요."

# proguard-rules.pro

# Keep data classes used with Gson reflection
-keep class com.example.app.model.** { *; }

# Keep Retrofit interface methods
-keepattributes Signature
-keepattributes *Annotation*

# Keep Kotlin metadata used by libraries
-keep class kotlin.Metadata { *; }

앱 버전 관리

각 릴리스에는 build.gradle.kts에 다음 두 가지 버전 값이 필요합니다.

versionCode — 업로드할 때마다 증가해야 하는 정수입니다. Play는 이를 사용해 어떤 빌드가 더 최신인지 확인합니다.
versionName — 사용자에게 표시되는 "1.4.0"과 같은 사람이 읽을 수 있는 문자열입니다.

versionCode를 올리는 것을 잊으면 Play는 중복 업로드로 판단하여 업로드를 거부합니다.

android {
    defaultConfig {
        applicationId = "com.example.app"
        minSdk = 24
        targetSdk = 35
        versionCode = 12
        versionName = "1.4.0"
    }
}

Android Studio에서 번들 빌드하기

사용자 인터페이스에서 서명된 릴리스 번들을 만들려면 다음 단계를 따르세요.

Build → Generate Signed Bundle / APK를 엽니다.
Android App Bundle을 선택합니다.
키 저장소와 키를 선택하거나 새로 만듭니다.
release 빌드 변형을 선택합니다.

Android Studio가 R8을 실행하고 번들에 서명한 다음 .aab를 app/release/에 저장합니다. Play에 업로드하는 파일은 바로 이 하나의 파일입니다.

명령줄에서 빌드하기

CI/CD 또는 스크립트에서는 Gradle을 직접 사용해 번들을 빌드합니다. 작업 이름은 bundle<Variant> 패턴을 따릅니다.

bundleRelease는 AAB를 생성합니다. 파일은 app/build/outputs/bundle/release/에 저장됩니다.

# Build a release App Bundle (.aab)
./gradlew bundleRelease

# Output:
# app/build/outputs/bundle/release/app-release.aab

# Build a release APK instead (for direct install/testing)
./gradlew assembleRelease

AAB 검사 및 테스트

.aab는 휴대전화에 직접 설치할 수 없습니다. Play가 생성할 APK를 그대로 테스트하려면 Google의 bundletool을 사용하세요.

이 도구는 번들에서 기기별 APK를 만들고 연결된 기기에 설치합니다. 실제 Play 다운로드에 가장 가까운 방식입니다.

# Generate APKs from the bundle for the connected device
java -jar bundletool.jar build-apks \
  --bundle=app-release.aab \
  --output=app.apks \
  --connected-device

# Install them on the device
java -jar bundletool.jar install-apks --apks=app.apks

릴리스에서 디버그 코드 제거하기

릴리스 빌드에는 민감한 데이터를 기록하거나 디버그 전용 기능을 남겨 두어서는 안 됩니다. 동작을 분기할 때 BuildConfig.DEBUG를 사용하세요. 이 값은 디버그 빌드에서만 true입니다.

R8은 상수 false로 보호된 블록을 제거할 수도 있으므로 크기도 줄어듭니다.

fun setupLogging() {
    if (BuildConfig.DEBUG) {
        // Verbose logging only in debug builds
        Log.d("App", "Debug logging enabled")
        Timber.plant(Timber.DebugTree())
    } else {
        // Release: send to crash reporting only, no console spam
        Timber.plant(CrashReportingTree())
    }
}

릴리스 준비 체크리스트

최종 번들을 빌드하기 전에 다음을 확인하세요.

versionCode를 올리고 versionName을 업데이트했는가
릴리스에서 isMinifyEnabled와 isShrinkResources를 켰는가
리플렉션을 사용하는 라이브러리에 유지 규칙을 추가했는가
targetSdk가 Play의 현재 요구 사항을 충족하는가
릴리스 코드에 디버그 전용 기록이나 테스트 엔드포인트가 없는가
실제 기기에서 bundletool로 AAB를 테스트했는가

이 항목을 모두 통과하면 .aab를 업로드할 준비가 된 것입니다.

빠른 확인

isMinifyEnabled = true로 설정했는데 릴리스에서 JSON 분석기가 "class not found" 오류를 내며 앱이 비정상 종료되고 디버그에서는 정상적으로 작동합니다. 가장 가능성 높은 원인은 무엇인가요?

복습: 릴리스 빌드 준비

이제 디버그 앱을 게시 가능한 빌드로 전환하는 방법을 알게 되었습니다.

Play에는 서명된 .aab가 필요하며, Play는 이 파일에서 기기별 APK를 생성합니다.
release 빌드 유형은 isMinifyEnabled와 isShrinkResources를 통해 R8을 활성화하여 크기를 줄이고 난독화하며 최적화합니다.
유지 규칙은 리플렉션 기반 코드가 제거되지 않도록 보호합니다.
항상 versionCode를 올리고 versionName을 업데이트하세요.
./gradlew bundleRelease로 빌드하고 bundletool로 결과를 테스트하세요.

다음 학습 내용에서는 이 빌드를 신뢰할 수 있게 만드는 서명이 실제로 어떻게 작동하는지 알아봅니다.

자주 묻는 질문

“릴리스 빌드 준비” 강의는 무료인가요?

네 — “릴리스 빌드 준비” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Android Academy 강의 전체를 잠금 해제할 수 있습니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“릴리스 빌드 준비”에서 뭘 배우나요?

앱 번들과 크기 축소를 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 Android Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Android Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Android Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“릴리스 빌드 준비” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Android Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Android Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Android Academy(으)로 돌아가기