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

소개

이 섹션에서는 Git 버전 관리 시스템을 통해 Qt 소스를 가져오는 방법을 설명합니다. 이 방법은 이미 Git을 사용하는 소프트웨어 개발 프로세스나 다른 Qt 버전을 테스트할 때 유용합니다. 또한 Qt에 기여하려는 경우에도 필수적입니다.

참고: Qt 소스는 Qt Online Installer 를 사용하여 설치할 수도 있으며, Qt 계정 (상용 사용자)에서 아카이브로 다운로드하거나 download.qt.io (오픈 소스 사용자)에서 다운로드할 수도 있습니다.

Qt는 qt5 슈퍼 모듈에 묶인 여러 Git 서브모듈에서 개발 및 유지 관리됩니다. Git에서 Qt 소스를 얻으려면 Git 명령줄을 통해 최상위 Git 저장소를 복제하고 Qt configure 명령을 사용하여 서브모듈을 초기화해야 합니다.

참고: Qt 5와 Qt 6는 동일한 리포지토리를 공유하므로 Qt 6를 사용하더라도 qt5 리포지토리에 대해 작업하게 됩니다.

준비 과정

먼저 Qt 소스 빌드하기 및 플랫폼에 대한 요구 사항 섹션을 검토하여 모든 필수 요구 사항이 설치되었는지 확인합니다. 또한 최신 버전의 Git이 필요합니다.

Qt 소스를 복제할 위치를 계획할 때 Qt는 소스 코드가 빌드 아티팩트와 별도로 존재하는 아웃 오브 소스 빌드를 지원한다는 점을 염두에 두세요. 이렇게 하면 Git 클론이 깨끗하게 유지되고 동일한 소스 트리에서 다른 버전의 Qt를 빌드할 수 있습니다. 이 개요에서 Qt 소스가 포함된 디렉터리를 qt-sources 이라고 하고 빌드 아티팩트가 포함된 디렉터리를 qt-build 이라고 합니다.

Qt Git 저장소 복제하기

qt-sources 디렉터리를 생성하는 것으로 시작합니다. 이 디렉토리 내에서 Git을 사용하여 소스를 복제합니다. 여기서는 Git 명령줄 인터페이스를 사용합니다. 뒤에 오는 '.' 문자는 Qt가 현재 디렉터리에 복제되었음을 나타냅니다.

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

https 프로토콜을 사용할 수도 있습니다.

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

최신 개발 버전을 테스트하려면 --branch 인수를 생략하세요.

Qt 서브모듈 초기화하기

다음으로 빌드 디렉터리 qt-build 를 생성합니다. 이 디렉토리 내에서 -init-submodules 옵션으로 configure 명령을 실행합니다.

qt-sources/configure -init-submodules

그러면 qt-sources 디렉터리에 있는 모든 Qt 서브모듈이 재귀적으로 초기화되며, 시간이 다소 걸릴 수 있습니다.

-init-submodules 은 다른 config 인자와 함께 사용할 수 있습니다. 작업할 Qt 서브모듈을 알고 있다면 -submodules 인수를 사용하여 구성 시간을 줄이세요.

qt-sources/configure -init-submodules -submodules qtdeclarative

그러면 qtdeclarative 및 필수 서브모듈이 초기화됩니다.

Qt 빌드하기

Qt 소스가 설정되면 Qt 소스 빌드하기에서 설명한 대로 플랫폼에 맞는 Qt 빌드를 진행합니다. -init-repository 인수는 초기 Qt 구성 중과 브랜치 전환 후에만 필요합니다.

Qt에 기여하기

Qt에 기여하려는 경우, Qt를 처음 구성할 때 -codereview-username 을 지정하십시오.

qt-sources/configure -init-submodules -codereview-username <Gerrit username>

Qt에 기여하고 Gerrit 사용자 이름을 만드는 방법에 대한 자세한 내용은 Qt 프로젝트 홈페이지를 참조하십시오.

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