Google Play에 퍼블리싱하기

안드로이드용Qt는 안드로이드용 애플리케이션을 개발, 빌드 및 패키징할 수 있는 완벽한 솔루션을 제공합니다. 이러한 작업의 대부분, 특히 패키징 및 배포는 Qt Creator 에서 처리하여 풍부한 개발자 경험을 제공합니다.

Qt Creator 을 사용하여 애플리케이션을 실행할 때마다 Android 애플리케이션 패키지(APK)가 생성되어 선택한 대상(디바이스 또는 에뮬레이터)에 배포됩니다. 패키징 설정을 약간만 변경하면 Google Play에 애플리케이션을 게시할 수 있습니다.

앱 빌드

앱이 개발되어 Google Play에 게시하려면 다음 지침에 따라 .apk 또는 .aab 을 만들어 Google Play에 게시하세요:

  1. Qt Creator 으로 프로젝트를 열고 Release Build 을 선택합니다.
  2. Projects > Build > Build Android APK > Create Templates 을 선택하여 AndroidManifest.xml 과 같은 안드로이드 패키지 템플릿 파일을 만듭니다.
  3. AndroidManifest.xml 에서 다음 설정을 확인합니다:

    자세한 내용은 Qt 안드로이드 매니페스트 파일 구성을 참조하십시오.

  4. 앱의 필요에 따라 minimumtarget SDK 버전을 설정합니다. 이 작업은 CMake 속성 QT_ANDROID_TARGET_SDK_VERSIONQT_ANDROID_MIN_SDK_VERSION을 사용하여 수행할 수 있습니다. 또는 qmake 안드로이드_타겟_SDK_버전 안드로이드_미니_SDK_버전의 경우.

    참고: Qt 5.15에서와 마찬가지로 AndroidManifest.xml 에서 이러한 설정을 지정할 수 있습니다. 여기에 설정된 경우 위에서 언급한 CMake 및 qmake 속성이 이를 재정의한다는 점에 유의하세요. Android를 참조하십시오 : build.gradle 에서 설정하는 방법에 대한 자세한 내용은 안드로이드: 앱 버전 관리를 참조하십시오.

  5. 패키지에 서명할 키 저장소를 설정합니다. 키 저장소가 없는 경우 새 키 저장소를 만들 수 있습니다. 자세한 내용은 Android 패키지 서명하기를 참조하세요.
  6. 생성된 패키지를 찾습니다:
    • APK 패키지의 경우 .apk 패키지를 찾습니다:
      <build_path>/android-build/build/outputs/apk/release/android-build-release.apk

      참고: Qt Creator 에서 Projects > Build > Build Steps > Build Android APK > Open package location after build 를 선택하여 애플리케이션의 .apk 을 빌드하고 패키지가 포함된 디렉토리를 엽니다.

    • AAB 패키지의 경우 Qt Creator 에서 Projects > Build > Build Steps > Build Android APK > Build .aab (Android App Bundle) 를 선택하여 .aab 파일을 생성한 다음 패키지를 찾습니다:
      <build_path>/android-build/build/outputs/bundle/release/android-build-release.aab

Google Play 스토어에 앱 업로드하기

Google Play 개발자 콘솔에 로그인하여 .aab 파일과 함께 애플리케이션의 사용법과 유사한 설명 및 화면 캡처를 업로드합니다.

다중 ABI 번들

멀티-ABI 번들 빌드를 지원하는 Qt 버전에서는 지원되는 모든 아키텍처가 포함된 .aab 파일 하나만 업로드하면 됩니다. Qt 6.8은 CMake만으로 다중 ABI 번들 빌드를 지원합니다. 자세한 내용은 QT_ANDROID_ABIS를 참조하십시오.

단일-ABI 번들

그러나 앱을 게시하려면 멀티-ABI 빌드를 지원하지 않는 Qt 버전에 대한 추가 단계가 필요합니다. Qt 6.8의 qmake 빌드가 이 범주에 속합니다.

단일 ABI 키트를 사용하여 빌드한 앱을 게시하려면 각 ABI가 서로 다른 내부 버전 코드를 사용하는지 확인해야 합니다. 버전 코드는 앱 릴리스를 위한 내부 비공개 식별자입니다. 지원하려는 아키텍처를 각각 빌드하고 각 ABI에 대해 서로 다른 버전 코드를 설정하세요. qmake의 경우 다음과 같이 할 수 있습니다:

ANDROID_VERSION_CODE = <unique_version>

앱 개발자는 버전 코드에 특정 체계를 사용할 수 있습니다. 예를 들어 코드에 플랫폼, ABI 및 실제 버전에 대한 청크가 있을 수 있습니다. 그런 다음 샘플 체계는 <Platform><ABI><AppVersion> 입니다:

  • Platform:
    • Arm의 경우 1
    • Intel의 경우 2
  • 아키텍처:
    • 32비트용 32
    • 64비트용 64

arm64-v8a ABI용 릴리스 1.0의 결과 버전 코드는 16410 입니다.

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

다음 스크린샷은 4개의 ABI를 대상으로 하는 앱의 예를 보여 주며, 각 패키지는 공개 버전 문자열인 버전 이름과는 다른 고유한 버전 코드를 사용합니다.

Android에 애플리케이션 배포하기를참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.