이 페이지에서

Qt Quick Controls 애플리케이션 배포

Qt Quick Controls 애플리케이션의 배포는 다른 유형의 Qt 애플리케이션 배포와 매우 유사합니다. 하지만 고려해야 할 몇 가지 사항이 있습니다.

여러 스타일을 가진 애플리케이션 배포

Android 및 Windows 기기 모두에 배포될 애플리케이션이 있다고 가정해 봅시다. 애플리케이션 실행에 필요한 최소한의 파일 세트만 각 기기에 배포되도록 하려면 파일 선택기를 사용할 수 있습니다. 예를 들어, 디렉터리 구조는 다음과 같을 수 있습니다:

resources.qrc
main.qml
+windows/MyPage.qml
+windows/qtquickcontrols2.conf
+android/MyPage.qml
+android/qtquickcontrols2.conf

위의 프로젝트에서 main.qml 는 QtQuick.Controls 를 임포트하지만, QtQuick.Controls.Material 는 임포트하지 않아야 합니다. 특정 스타일에만 적용되는 코드는 별도의 파일로 분리되며, 이는 MyPage.qml 에서 수행한 방식과 동일합니다.

+windows/qtquickcontrols2.conf 파일에는 Universal 스타일에 특화된 구성 옵션이 포함됩니다:

[Controls]
Style=Universal

[Universal]
Theme=Dark
Accent=Red

+android/qtquickcontrols2.conf 파일에는 Material 스타일에 특화된 구성 옵션이 포함됩니다:

[Controls]
Style=Material

[Material]
Theme=Light
Accent=Brown

정적 빌드

동적으로 빌드되는 애플리케이션의 경우, 해당 애플리케이션에서 사용해야 할 특정 스타일을 임포트할 필요가 없습니다. 정적으로 빌드되는 애플리케이션의 경우, QML 플러그인이 예상대로 작동하도록 보장하기 위해 Qt의 빌드 시스템을 활용해야 합니다. 구체적으로, qmake 는 qmlimportscanner 를 사용하여 애플리케이션 내 QML 파일에서 임포트 문장을 스캔합니다. 이러한 이유로, 정적 빌드된 애플리케이션에서 사용 가능해야 하는 모든 스타일은 해당 스타일을 명시적으로 가져와야 합니다. 가져오기 문이 어디에 위치할지는 개발자가 결정할 수 있지만, 특정 기기에 필요한 최소한의 파일 세트만 배포되도록 하기 위해 “여러 스타일이 포함된 애플리케이션 배포” 섹션에서 언급된 방식을 따르는 것이 권장됩니다.

Qt Quick Controls 의‘Qt 애플리케이션 배포 ’ 및 ‘스타일 사용’항목도 참조하십시오 .

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