QT_ANDROID_GRADLE_MULTI_MODULE

다중 모듈 Gradle 프로젝트에서 Android 패키지를 빌드합니다.

이 변수는 Qt 6.12에서 도입되었습니다.

Android 아티팩트당 하나의 모듈, 애플리케이션을 위한 ‘ app ’ 모듈, 그리고 각 동적 기능당 하나의 모듈을 포함하는 Gradle 프로젝트에서 애플리케이션을 패키징하려면 이 변수를 ‘ TRUE ’로 설정하십시오:

<build>/android-build-<target>/
    app/                    # the application module
    <feature_1_target>/     # Dynamic feature 1
    <feature_2_target>/     # Dynamic feature 2
    settings.gradle         # includes app and other dynamic features

기능 모듈은 Play Feature Delivery가 기반으로 하는 요소이므로, ` qt_add_android_dynamic_features() `에는 이 변수가 필요합니다. 자세한 내용은 `qt_add_android_dynamic_feature_java_source_dirs` 를 참조하십시오. 이를 사용하는 전체 프로젝트 예제는 'Play Feature Delivery 사용하기'를 참조하십시오.

프로젝트를 구성할 때 이 변수를 설정하십시오:

qt-cmake -S <source_dir> -B <build_dir> -DQT_ANDROID_GRADLE_MULTI_MODULE=ON

또는 qt_add_executable() 호출 직전, 즉 실행 파일이 생성되기 전에 변수가 인식될 수 있도록 설정하십시오:

set(QT_ANDROID_GRADLE_MULTI_MODULE ON)

이 변수는 패키지를 어떻게 빌드할지도 결정합니다. 기본적으로 CMake는 배포 설정 파일을 작성하고 나머지는 androiddeployqt에 넘기는데, androiddeployqt는 Qt 의존성을 해결하고 이를 빌드 디렉터리로 복사한 뒤, 그곳에서 Gradle을 실행합니다. 이 변수가 활성화되면, CMake가 의존성을 일반 빌드 단계로 직접 배포하고 모든 모듈의 Gradle 파일을 생성합니다. 그러면 apk 및 aab 타깃이 Gradle을 직접 실행하며, androiddeployqt는 전혀 관여하지 않습니다. 애플리케이션은 ` android-build-<target>/app`에서 패키징되며, 배포된 파일들은 패키지의 빌드 종속성으로 포함됩니다. 이 옵션은 CMake 빌드 그래프에 의존하고 추가적인 배포 도구를 사용하지 않기 때문에 일반적으로 더 빠르고 간단합니다.

이 변수는 Qt 6.11부터 QT_USE_ANDROID_MODERN_BUNDLE 로 사용할 수 있습니다. 이 이름은 Qt 6.12부터 사용 중단되었으나, 설정되어 있으면 여전히 적용됩니다.