이 페이지에서

qt_android_add_apk_target

APK를 생성하기 위해 androiddeployqt를 실행하는 빌드 타깃을 정의합니다.

이 명령어는 Qt6 패키지의 Core 컴포넌트에 정의되어 있으며, 다음과 같이 불러올 수 있습니다:

find_package(Qt6 REQUIRED COMPONENTS Core)

이 명령어는 Qt 6.0에서 도입되었습니다.

경고: 이 명령어는 Qt 6.5부터 더 이상 사용되지 않습니다. 대신 qt_add_executable() 을 사용하십시오.

참고: 이 명령어는 Android 플랫폼을 대상으로 하는 경우에만 호출해야 합니다.

개요

qt_android_add_apk_target(target)

버전 정보가 없는 명령어가 비활성화된 경우, 대신 qt6_android_add_apk_target() 을 사용하십시오. 이 명령어와 동일한 인자 세트를 지원합니다.

설명

이 명령어로 생성된 <target>_make_apk, <target>_make_aab 및 <target>_make_aar 사용자 정의 타깃은 Android 배포 설정 파일을 받아 androiddeployqt 를 실행하여 각각 APK, AAB 및 AAR 패키지를 생성합니다. 설정 파일의 위치는 target 의 QT_ANDROID_DEPLOYMENT_SETTINGS_FILE 속성에서 가져옵니다. 이 파일은 일반적으로 qt_android_generate_deployment_settings()에 의해 생성됩니다. 해당 Android 패키지는 target 의 CMake 빌드 디렉터리 아래에 있는 android-build 하위 디렉터리에 생성됩니다.

<target>_make_apk, <target>_make_aab 및 <target>_make_aar 타깃은 각각 apk, aab 및 aar 빌드 타깃의 종속성으로 자동 추가되며, 이 타깃들은 자동으로 생성됩니다. QT_NO_GLOBAL_APK_TARGET, QT_NO_GLOBAL_AAB_TARGET 및 QT_NO_GLOBAL_AAR_TARGET 변수를 TRUE 로 설정하면 apk, aab 및 aar 타깃의 생성을 비활성화할 수 있습니다.

예시

qt_android_generate_deployment_settings(myapp)
qt_android_add_apk_target(myapp)

위의 명령어는 myapp_make_apk, myapp_make_aab, myapp_make_aar, apk, aab 및 aar 빌드 타깃을 정의하며, 이를 사용하여 각각 myapp 패키지만 생성하거나 프로젝트의 모든 APK, AAB 및 AAR을 생성할 수 있습니다.

qt_android_generate_deployment_settings(), qt_finalize_target() 및 qt_finalize_project()도 참조하십시오 .

© 2026 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.