Google Play에 퍼블리싱하기

안드로이드용 Qt는 안드로이드 앱을 개발, 빌드 및 패키징하는 데 필요한 모든 것을 제공합니다. 이 가이드는 앱을 구성, 빌드 및 Google Play 콘솔에 게시하는 방법을 보여줍니다.

앱 구성하기

CMake API를 사용하거나 매니페스트를 직접 편집하여 Android 앱 설정을 구성합니다. 안드로이드 앱은 AndroidManifest.xml 및 Gradle 빌드 파일에서 다양한 설정이 필요합니다. Qt 6는 프로젝트에서 이러한 설정을 관리할 수 있는 편리한 CMake API를 제공합니다.

필수 앱 속성 설정

앱의 패키지 이름, 버전 및 Android SDK 요구 사항을 정의합니다:

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_PACKAGE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/android"
    QT_ANDROID_PACKAGE_NAME "io.qt.calqlatr"
    QT_ANDROID_APP_NAME "Calqlatr"
    QT_ANDROID_TARGET_SDK_VERSION 35
    QT_ANDROID_MIN_SDK_VERSION 28
    QT_ANDROID_VERSION_NAME "1.0"
    QT_ANDROID_VERSION_CODE 10
)

앱 아이콘 구성

앱 아이콘을 설정하고 올바른 디렉터리에 아이콘 파일을 생성합니다:

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_APP_ICON "@drawable/ic_launcher"
)

아이콘 파일을 배치합니다:

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

다음을 사용하여 아이콘 파일을 만들 수 있습니다:

• Qt Creator 안드로이드 아이콘 생성기
• 안드로이드 스튜디오: 이미지 에셋 스튜디오
• 온라인 안드로이드 아이콘 생성기

플러그인 패키징 최적화

포함할 플러그인을 지정하여 앱 크기를 줄이세요. 안드로이드 배포 도구에는 런타임에 앱에 필요하지 않은 플러그인이 포함될 수 있습니다:

qt_import_plugins(${appname}
    INCLUDE_BY_TYPE imageformats Qt::QSvgPlugin Qt::QJpegPlugin
    EXCLUDE_BY_TYPE iconengines networkinformation tls platforminputcontexts qmltooling
)

관련 문서

• 안드로이드용 Qt 매니페스트 파일 구성
• androiddeployqt 도구

앱 빌드하기

출시용 앱을 빌드하고 Google Play 콘솔 제출을 준비하세요.

릴리스 빌드 구성

Google Play에는 릴리스 빌드가 필요합니다. 디버그 정보는 별도의 파일로 포함할 수 있으며 더 나은 크래시 보고를 위해 권장됩니다:

qt-cmake -DCMAKE_BUILD_TYPE=Release

매니페스트 또는 Gradle 구성에서 디버깅 가능이 false 으로 설정되어 있는지 확인합니다.

다중 ABI 지원 사용

여러 디바이스 아키텍처에 맞게 앱을 빌드하여 호환성을 극대화하세요:

qt-cmake -DQT_ANDROID_BUILD_ALL_ABIS:BOOL=ON ...

서명 키 만들기

Google Play 콘솔에는 서명된 앱 릴리스가 필요합니다. Google은 두 개의 키로 Google Play 관리형 서명을 사용할 것을 권장합니다:

• 서명 키: Google Play 콘솔에서 앱을 만들 때 Google에서 생성 및 관리합니다.
• 업로드 키: 업로드할 앱 번들에 서명하기 위해 로컬에서 관리됨

keytool -genkey -keyalg RSA -keystore upload-key.keystore \
    -alias play_apps \
    -storepass <password> -keypass <key-password> \
    -dname "CN=<n>, OU=<unit>, O=<organisation>, L=<city>, ST=<state>, C=<country>"

qt-cmake -DQT_ANDROID_SIGN_APK:BOOL=ON -DQT_ANDROID_SIGN_AAB:BOOL=ON ...

export QT_ANDROID_KEYSTORE_PATH=upload-key.keystore
export QT_ANDROID_KEYSTORE_ALIAS=play_apps
export QT_ANDROID_KEYSTORE_STORE_PASS=<password>
export QT_ANDROID_KEYSTORE_KEY_PASS=<key-password>

앱 번들(AAB) 생성하기

이제 Google Play 콘솔은 주로 APK 대신 안드로이드 앱 번들(AAB)을 허용합니다. AAB 패키지를 사용하면 Google Play에서 각 기기에 맞게 앱 전송을 최적화할 수 있습니다.

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

관련 문서

• Google Play 앱 서명 가이드
• 안드로이드 앱 번들 FAQ

Google Play 콘솔에 퍼블리싱

앱을 빌드하고 서명한 후에는 배포를 위해 Google Play 콘솔에 게시합니다.

업로드 준비

업로드하기 전에:

1. 다양한 기기 및 Android 버전에서 앱을 철저히 테스트합니다.
2. 홍보 자료(스크린샷, 설명, 기능 그래픽)를 준비합니다.
3. Google Play의 콘텐츠 정책 및 가이드라인을 검토합니다.

Google Play 콘솔에서 앱 만들기

1. Google Play 콘솔에 로그인
2. 새 앱을 만들거나 기존 앱을 선택합니다.
3. 앱 세부 정보 및 콘텐츠 등급 설문지를 작성합니다.
4. 가격 및 배포 설정 설정

계정이 없는 경우 계정을 만들려면 Google Play 콘솔 설정 가이드를 참조하세요.

앱 번들 업로드

1. Release > Production
2. 새 릴리스 만들기
3. 서명된 AAB 파일을 업로드합니다.
4. 릴리스 노트 추가
5. 릴리스 검토 및 롤아웃

리소스

• 앱 만들기 및 설정
• Google 앱 퍼블리싱 가이드
• Google Play 콘솔 웨비나

특별 고려 사항

레거시 프로젝트를 위한 단일-ABI 빌드

멀티-ABI 빌드를 지원하지 않는 Qt 버전(예: qmake 프로젝트)의 경우 각 아키텍처를 다른 버전 코드로 개별적으로 빌드하세요:

ANDROID_VERSION_CODE = <unique_version>

<Platform><ABI><AppVersion> 과 같은 버전 관리 체계를 사용하는 것이 좋습니다:

• 플랫폼: 1: Arm용, 2: Intel용
• 아키텍처: 32비트의 경우 32, 64비트의 경우 64

예시: arm64-v8a용 릴리스 1.0은 버전 코드 16410 를 사용합니다.

자세한 내용은 Google의 앱 버전 관리 문서를 참조하세요.