Google Play에 게시하기

Qt for Android는 안드로이드 앱을 개발, 빌드 및 패키징하는 데 필요한 모든 기능을 제공합니다. 이 가이드에서는 앱을 구성하고, 빌드하며, Google Play Console에 게시하는 방법을 설명합니다.

앱 구성

CMake API를 사용하거나 매니페스트를 직접 편집하여 Android 앱 설정을 구성하십시오. 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 Android 아이콘 생성기
• Android Studio: 이미지 자산 스튜디오
• 온라인 Android 아이콘 생성기

플러그인 패키징 최적화

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

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

관련 문서

• Android용 Qt 매니페스트 파일 구성
• androiddeployqt 도구

앱 빌드

릴리스용 앱을 빌드하고 Google Play Console에 제출할 수 있도록 준비합니다.

릴리스 빌드 구성

Google Play에서는 릴리스 빌드를 요구합니다. 디버그 정보는 별도의 파일로 포함할 수 있으며, 더 정확한 충돌 보고를 위해 이를 권장합니다:

qt-cmake -DCMAKE_BUILD_TYPE=Release

매니페스트 또는 Gradle 구성에서 'debuggable'이 ' 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 대신 주로 Android 앱 번들(AAB)을 지원합니다. AAB 패키지를 사용하면 Google Play에서 각 기기에 맞게 앱 배포를 최적화할 수 있습니다.

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

관련 문서

• Google Play 앱 서명 가이드
• Android 앱 번들 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 Console 웨비나

특별히 고려해야 할 사항

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

다중 ABI 빌드를 지원하지 않는 Qt 버전(예: qmake 프로젝트)의 경우, 서로 다른 버전 코드를 사용하여 각 아키텍처를 별도로 빌드하십시오:

ANDROID_VERSION_CODE = <unique_version>

<Platform><ABI><AppVersion> 와 같은 버전 지정 방식을 고려해 보세요:

• 플랫폼: Arm은 1, Intel은 2
• 아키텍처: 32비트는 32, 64비트는 64

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

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