이전 목록으로
#Android#Gradle

Android Release 빌드: APK·AAB·서명·R8까지

`assembleRelease`와 `bundleRelease`의 차이, 릴리스 서명, R8 최적화와 배포 전 검증을 정리한다.

개발 빌드는 Run 버튼으로 끝나지만 배포 빌드는 산출물, 인증서, 최적화를 함께 확인해야 한다.

APK와 AAB

./gradlew :app:assembleRelease
./gradlew :app:bundleRelease
  • APK: 기기에 직접 설치하거나 내부 테스트할 때 편하다.
  • AAB: Google Play 게시 형식이다. Play가 기기에 맞는 APK를 생성한다.
app/build/outputs/apk/release/app-release.apk
app/build/outputs/bundle/release/app-release.aab

릴리스 설정

android {
    signingConfigs {
        create("release") {
            keyAlias = providers.gradleProperty("RELEASE_KEY_ALIAS").get()
            keyPassword = providers.gradleProperty("RELEASE_KEY_PASSWORD").get()
            storeFile = file(providers.gradleProperty("RELEASE_STORE_FILE").get())
            storePassword = providers.gradleProperty("RELEASE_STORE_PASSWORD").get()
        }
    }
    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
            isMinifyEnabled = true
            isShrinkResources = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro",
            )
        }
    }
}

키와 비밀번호는 저장소에 올리지 않는다. R8은 사용하지 않는 코드 제거·최적화·난독화를 수행한다. Debug는 정상인데 Release만 실패하면 리플렉션, JSON 직렬화, JNI 대상의 keep rule과 mapping.txt를 확인한다.

체크리스트

  • 실제 기기에 Release APK를 설치한다.
  • 기존 배포 앱 위에 업데이트되는지 확인한다.
  • 로그인·푸시·딥링크·카메라를 점검한다.
  • AAB는 Play Console 내부 테스트에서 검증한다.

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.