Lightbuild 앱 게시

Google Play에 앱을 게시하려면 앱의 출시 버전을 Android App Bundle로 빌드하고 업로드 키로 서명한 후 Play Console에 업로드합니다. 이 페이지에서는 Lightbuild 프로젝트에서 출시 서명을 구성하고 Lightbuild CLI를 사용하여 서명된 App Bundle을 빌드하는 방법을 보여줍니다.

업로드 키 만들기

Google Play는 Play 앱 서명을 사용하여 사용자에게 제공하는 APK에 서명하고, 개발자는 업로드 키를 사용하여 업로드하는 App Bundle에 서명합니다. 아직 업로드 키가 없다면 JDK에 포함된 keytool를 사용하여 업로드 키를 만듭니다.

keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

이 명령어는 키 저장소와 키의 비밀번호를 입력하라는 메시지를 표시한 후 현재 디렉터리에 upload-keystore.jks라는 키 저장소 파일을 만듭니다. 키 저장소를 프로젝트 외부의 안전한 위치에 저장하고 버전 제어에 체크인하지 마세요. 자세한 내용은 앱 서명을 참고하세요.

출시 서명 구성

앱 모듈의 lightbuild.yaml 파일에서 signing 블록을 packaging의 release 프로필에 추가합니다. 파일에 비밀번호를 작성하는 대신 ${NAME} 구문을 사용하여 환경 변수를 참조합니다.

android:
  packaging:
    release:
      signing:
        storeFile: "${RELEASE_STORE_FILE}"
        storePassword: "${RELEASE_STORE_PASSWORD}"
        keyAlias: "${RELEASE_KEY_ALIAS}"
        keyPassword: "${RELEASE_KEY_PASSWORD}"

빌드할 때 Lightbuild는 환경 변수에서 각 값을 읽으므로 비밀번호가 프로젝트 파일에 저장되지 않습니다. 이러한 설정에 관한 자세한 내용은 Lightbuild 구성 참조의 패키징을 참고하세요.

환경 변수를 설정하고,

빌드하기 전에 Lightbuild CLI를 실행하는 터미널에서 환경 변수를 설정합니다. 예를 들어 macOS 또는 Linux의 경우 다음과 같습니다.

export RELEASE_STORE_FILE="$HOME/keystores/upload-keystore.jks"
export RELEASE_STORE_PASSWORD="KEYSTORE_PASSWORD"
export RELEASE_KEY_ALIAS="upload"
export RELEASE_KEY_PASSWORD="KEY_PASSWORD"

Windows의 PowerShell에서 다음을 실행합니다.

$env:RELEASE_STORE_FILE = "$HOME\keystores\upload-keystore.jks"
$env:RELEASE_STORE_PASSWORD = "KEYSTORE_PASSWORD"
$env:RELEASE_KEY_ALIAS = "upload"
$env:RELEASE_KEY_PASSWORD = "KEY_PASSWORD"

KEYSTORE_PASSWORD 및 KEY_PASSWORD를 비밀번호로 바꿉니다. CI 시스템에서 비밀번호를 보안 비밀로 저장하고 빌드에 환경 변수로 노출합니다.

서명된 App Bundle 빌드

출시할 때마다 앱 모듈의 lightbuild.yaml 파일에서 versionCode 설정을 늘리고 필요한 경우 versionName를 업데이트합니다. Google Play에서는 업로드할 때마다 더 높은 버전 코드가 필요합니다. 자세한 내용은 앱 버전 지정을 참고하세요.

서명된 출시 App Bundle을 빌드하려면 다음을 실행합니다.

lightbuild build app:app-release.aab

Lightbuild가 번들을 app/build/app-release.aab에 작성합니다. 앱 모듈의 각 타겟이 출력을 쓰는 위치를 확인하려면 lightbuild query app/... --output=files를 실행합니다.

Google Play에 앱 업로드

서명된 App Bundle을 Play Console에 업로드합니다. 사용자에게 앱을 출시하기 전에 테스트하려면 먼저 내부 테스트 트랙에 업로드하세요. 자세한 내용은 Play Console에 앱 업로드를 참고하세요.