QML 애플리케이션 배포
이 페이지에서는 QML 애플리케이션을 배포하는 방법에 대한 정보를 제공합니다. 여기에는 배포를 위한 Qt Creator 의 사용법과, QML 파일 및 기타 리소스를 애플리케이션 실행 파일과 함께 패키징하기 위한 Qt 리소스 시스템의 사용법이 포함됩니다.
xml-ph-0000@deepl.internal를 사용하여 Qt Creator
Qt Creator 는 QML 애플리케이션을 다양한 플랫폼에 배포하고 패키징합니다. 모바일 기기의 경우, Qt Creator 는 애플리케이션을 APK와 같은 해당 플랫폼의 패키지 형식으로 직접 번들링할 수 있습니다.
대상 플랫폼에서 애플리케이션을 실행할 때, 애플리케이션은 QML 라이브러리의 위치에 접근할 수 있어야 합니다. qmake를 사용하는 경우, QT_INSTALL_QML 환경 변수가 라이브러리의 위치를 가리킵니다. Qt 설치 프로그램은 QML 라이브러리를 다음 디렉터리에 설치합니다: <version>/ <COMPILER>/qml directory.
Qt Qml에서 Qt 리소스 시스템 사용하기
Qt 리소스 시스템을 사용하면 리소스 파일을 애플리케이션 실행 파일 내에 바이너리 파일로 저장할 수 있습니다. Qt 리소스 시스템은 QML 파일 및 이미지, 사운드 파일과 같은 기타 리소스를 파일 시스템 리소스에 대한 상대 경로나 절대 경로 대신 리소스 시스템 URI 체계를 통해 참조할 수 있게 해주므로, Qml 애플리케이션에 사용됩니다.
참고: 리소스 시스템을사용한다는 것은 QML 소스 파일이 변경될 때마다 패키지 내의 리소스를 업데이트하기 위해 일반적으로 애플리케이션 실행 파일을 재컴파일해야 함을 의미합니다.
CMake QML 모듈 API는 QML 파일을 리소스 시스템에 자동으로 배치합니다. 이러한 파일에 접근하려면 메인 QML 파일을 리소스로 로드하거나 qrc 스키마를 사용하는 URL로 로드하십시오. QML 파일이 리소스 시스템 내 어디에 배치되는지 확인하려면 다음을 연결하여 경로를 찾을 수 있습니다:
- qt_add_qml_module에 전달한
RESOURCE_PREFIX. /qt/qml, qt_add_qml_module 에RESOURCE_PREFIX을 전달 하지 않았고 QTP0001 정책이NEW로 설정된 경우./, qt_add_qml_module에RESOURCE_PREFIX을 전달하지 않았고 QTP0001 정책이not로 설정된 경우NEW로 설정됩니다.NO_RESOURCE_TARGET_PATH을 qt_add_qml_module에 전달하지 않은 경우: qt_add_qml_module 에 전달한URI에서 점(.)을 슬래시(/)로 대체한 경로입니다.
예를 들어, My.Own.Module 라는 모듈은 다음 위치에 배치됩니다:
:/qt/qml/My/Own/Module/RESOURCE_PREFIX로 을 지정했거나, 를/qt/qmlRESOURCE_PREFIX전달하지 않았으며 QTP0001 정책이 로 설정된 경우입니다.NEW:/My/Own/Module//을 로 지정했거나, 를RESOURCE_PREFIXRESOURCE_PREFIX통과하지 않았으며 QTP0001 정책이 로 설정NEW되지 않은 경우.:/Some/Prefix/My/Own/Module/Some/Prefix/를RESOURCE_PREFIX:/다음과 같이 지정했다면NO_RESOURCE_TARGET_PATH
이 작업이 완료되면 QML에서 상대 경로로 지정된 모든 파일이 리소스 시스템에서 로드됩니다. 리소스 시스템의 사용은 QML 계층에 완전히 투명하게 이루어집니다. 즉, 모든 QML 코드는 상대 경로를 사용하여 리소스 파일을 참조해야 하며, qrc 형식을 사용해서는 안 됩니다. 이 형식은 C++ 코드에서 리소스 파일을 참조할 때만 사용해야 합니다.
참고: qmake를 사용할때는 파일을 리소스 시스템에 수동으로 배치해야 합니다. 구체적인 방법은 qmake 매뉴얼과 리소스 시스템에 대한 일반 문서를 참조하십시오. 이 경우에도 위에서 설명한 경로 명명 규칙을 따르는 것이 좋습니다.
관련 정보
© 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.
