[Android]안드로이드 Release APK 수동 서명 및 배포 방법

✅ 안드로이드 Release APK APK 수동 서명 및 배포 방법

안드로이드 프로젝트를 릴리즈 모드로 빌드한 후, 수동으로 APK에 서명하고 배포하는 절차를 정리해본다.

자동 서명이 어려운 환경(예: 키오스크, 테스트 장비 등)에서는 수동 서명이 더 확실한 방법이 될 수 있다.

---

1️⃣ 릴리즈 APK 빌드 (unsigned)

./gradlew assembleRelease

빌드가 완료되면 다음 경로에 app-release-unsigned.apk가 생성

[프로젝트]/app/build/outputs/apk/release/app-release-unsigned.apk

unsigned APK를 먼저 만드는 이유

• Android Gradle Plugin은 보안을 위해 자동 서명을 하지 않음
• 릴리즈 모드로 빌드하면 최적화된 바이너리(.apk)는 생성하지만, 서명은 개발자가 직접 해야 한다.
• 서명된 APK만이 Android 시스템에서 실제 설치가 가능하며, 앱 업데이트도 정상적으로 동작한다.

---

2️⃣ 수동으로 APK에 서명하기 (apksigner 사용)

Android SDK에 포함된 apksigner를 사용하여 직접 서명한다.

/Users/사용자이름/Library/Android/sdk/build-tools/버전/apksigner sign \
--ks /경로/keystore파일명.jks \
--ks-key-alias 키_별칭 \
--ks-pass pass:키스토어_비밀번호 \
--key-pass pass:키_비밀번호 \
--out app-release.apk \
app-release-unsigned.apk

예시

/Users/devuser/Library/Android/sdk/build-tools/36.0.0/apksigner sign \
--ks /Users/devuser/Documents/my-release-key.jks \
--ks-key-alias mykeyalias \
--ks-pass pass:myStorePassword \
--key-pass pass:myKeyPassword \
--out app-release.apk \
app-release-unsigned.apk

apksigner는 Android SDK의 build-tools 폴더에 포함되어 있습니다.

---

3️⃣ 서명 완료 후 확인

서명에 성공하면 같은 폴더에 app-release.apk 파일이 생성되면 완성!

이 파일이 최종 배포 가능한 APK

---

4️⃣ APK 배포 방법

• 본인은 키오스크에 설치해야해서 USB 저장장치에 복사하여 테스트 기기에 수동 설치
• adb 명령어로 직접 설치:

adb install -r app-release.apk

---

 

📦 정리

APK 파일을 생성app-release-unsigned.apk-> APK 파일에 서명apksigner -> APK 파일을 배포app-release.apk