이 페이지에서

Git 저장소에서 Qt 소스 가져오기

이 페이지에서는 공개 Git 저장소에서 Qt 소스 코드를 가져오는 방법을 설명합니다. Git 저장소에는 Qt 6의 최신 개발 브랜치와 릴리스된 버전이 포함되어 있습니다.

Qt 소스 코드는 Qt Online Installer, Qt 계정 (상업용 사용자) 또는 download.qt.io (오픈 소스 사용자)를 통해서도 얻을 수 있습니다.

Git 서브모듈을 초기화할 때 init-repository 도구를 실행하려면 최신 버전의 Git과 CMake 문서가 필요합니다.

참고: 이 지침은 사용자가 명령줄 도구 사용에 익숙하다고 가정합니다.

Qt 저장소 복제

Qt는 메인 qt5.git 저장소의 여러 Git 서브모듈에서 개발 및 유지 관리됩니다. Git에서 Qt 소스 코드를 가져오려면 명령줄을 통해 최상위 Git 저장소를 복제해야 합니다.

참고: Qt 5와 Qt 6은 qt5.git 라는 동일한 저장소를 공유하므로, Qt 6을 사용하더라도 Qt 5 저장소를 가져오게 됩니다.

이 지침에서는 유닉스 계열 셸 구문을 사용합니다. Windows에서도 명령어는 비슷합니다. 아래 명령어는 Qt 6의 최신 버전을 qt 이라는 디렉터리에 복제합니다.

git clone --branch v6.12.0 git://code.qt.io/qt/qt5.git qt

방화벽에 의해 git 프로토콜이 차단된 경우, 대신 HTTPS를 사용하는 것을 고려해 보십시오:

git clone --branch v6.12.0 https://code.qt.io/qt/qt5.git qt

클로닝이 완료되면, qt 디렉터리에는 설정 파일과 초기화되지 않은 Qt 서브모듈이 포함된 주요 Qt Git 저장소가 들어 있습니다.

Qt 서브모듈 초기화

qt5.git 저장소에는 Qt 모듈이 Git 서브모듈로 포함되어 있습니다. 서브모듈을 초기화하고 복제하려면 최상위 디렉터리에서 init-repository 도구를 실행하십시오.

./init-repository

Linux 환경이 없는 Windows에서는 대신 init-repository.bat 을 사용하십시오.

init-repository.bat

init-repository xml-ph-0001@deepl.internal는 Qt 소스 코드를 빌드하기 위해 서브모듈을 복제하고 설정 파일을 초기화합니다. 또한, 이 저장소에는 Qt 기여자들이 패치를 생성하고, 코드를 테스트하며, 문서를 생성하는 데 도움이 되는 도구들이 포함되어 있습니다. 기여에 대한 자세한 내용은 ‘Qt 기여하기 ( Contributing to Qt )’ 사이트를 방문하십시오.

동일한 디렉터리에 이미 Qt 저장소가 있는 경우, ` -f `를 전달하여 ` init-repository `가 서브모듈을 재초기화하도록 강제할 수 있습니다.

./init-repository -f

Qt 전용 서브모듈 초기화

특정 Qt 모듈 세트만 필요한 경우, init-repository 에 --module-subset 를 인수로 전달하여 최소한의 서브모듈 세트를 초기화하세요. 예를 들어, 인수로 essential 를 지정하여 Qt Essentials 모듈만 초기화할 수 있습니다.

./init-repository --module-subset=essential

Qt 애드온의 경우, 대신 addon 을 사용하십시오.

./init-repository --module-subset=addon

여러 하위 모듈을 동시에 선택할 수도 있습니다. 예를 들어, qtgrpc 및 qtmqtt 하위 모듈과 이에 필요한 하위 모듈을 함께 초기화하려면 다음 명령을 실행하십시오.

./init-repository --module-subset=qtgrpc,qtmqtt

init-repository 도구는 항상 최소한의 서브모듈 세트만 초기화합니다.

자세한 내용은 -help 을 인수로 지정하여 init-repository 설명서를 참조하십시오:

./init-repository -help

클론 및 초기화 후

다음 단계는 Qt를 구성하고 빌드하는 것입니다. 자세한 내용은 ‘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.