Windows용 Qt - 소스 코드로부터 빌드하기

이 페이지에서는 Windows용 Qt를 구성하고 빌드하는 과정을 설명합니다. 미리 빌드된 Windows용 Qt를 다운로드하여 설치하려면 'Qt 시작하기' 페이지의 지침을 따르십시오.

1단계: 소스 코드 확보

Qt 소스 코드는 Qt Online Installer 에서 설치할 수 있습니다. 소스 패키지는 Git을 통해서도 제공되며, Qt 계정 (상업용 사용자)의 아카이브 및 download.qt.io (오픈소스 사용자)에서도 이용할 수 있습니다.

Qt Online Installer 를 통해 소스 코드를 설치하면, Qt 설치 디렉터리(예: C:\Qt\6.12.0\Src와 같이 저장됩니다.

소스 아카이브를 다운로드한 경우, 원하는 디렉터리(예: C:\dev\Qt\src)에 압축을 풀어주세요.

2단계: 빌드 필수 구성 요소 설치 및 환경 설정

소스 코드에서 Qt를 빌드하려면 지원되는 컴파일러와 다양한 빌드 도구가 포함된 빌드 환경이 필요합니다.

빌드 도구

빌드 환경에는 cmake.exe, ninja.exe 및 python.exe 실행 파일이 반드시 있어야 합니다. 해당 디렉터리를 PATH 환경 변수에 추가하십시오.

컴파일러

Qt 6.12에서는 다음 컴파일러 및 구성이 지원됩니다:

QDoc 의존성

QDoc은 Clang을 사용하여 C++ 코드를 파싱합니다. QDoc을 수동으로 빌드하려는 경우, 구체적인 빌드 요구 사항에 대해서는 QDoc용 Clang 설치를 참조하십시오.

Qt GRPC Qt Protobuf 의 종속성

Qt GRPC 그리고 Qt ProtobufgRPC 및 Protobuf 패키지를 설치해야 합니다. 해당 패키지의 설치 방법은 ‘vcpkg를 사용한 Windows 설치 예시’에서 확인할 수 있습니다.

환경 설정

MSVC의 경우 다음 중 하나를 수행하십시오.

• vcvarsall.bat 파일을 실행하십시오:

  "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64

• Windows 검색 창에서 ‘VS Native Tools 명령 프롬프트’를 검색하십시오.

Mingw-w64의 경우: ‘ PATH ’ 환경 변수에 Mingw-w64를 추가하십시오:

Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%

3단계: Qt 라이브러리 및 도구 빌드

빌드를 구성하려면 빌드 디렉터리를 생성하고 이 디렉터리에서 configure.bat 스크립트를 실행하십시오:

mkdir C:\dev\qt-build
cd C:\dev\qt-build
C:\dev\Qt\src\configure.bat

기본적으로 Qt는 C:\Qt\Qt-major.minor.patch 디렉터리에 설치되도록 구성되어 있으며, 여기서 major.minor.patch 3개 숫자 조합은 빌드 중인 Qt 버전을 나타냅니다. 이는 -prefix 옵션을 사용하여 변경할 수 있습니다. 추가 조정이 필요하면 Qt 구성 옵션 목록을 참조하십시오.

그런 다음 라이브러리와 도구를 빌드합니다:

cmake --build . --parallel
# or
ninja

--build 뒤에 마침표(.)가 있으면 현재 폴더를 의미합니다.

빌드 후에는 ( 개발자 빌드를 활성화하지 않은 경우) 라이브러리와 도구를 원하는 경로에 설치해야 합니다:

cmake --install .
# or
ninja install

4단계: 애플리케이션 빌드

Qt 설치가 완료되면 Qt를 사용하여 애플리케이션 빌드를 시작할 수 있습니다.

명령줄에서 작업하는 경우, 다음과 같이 PATH 환경 변수에 Qt 도구를 추가하는 것을 고려해 보십시오:

set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%

IDE에서 애플리케이션을 빌드할 계획이라면, 해당 IDE에 Qt 버전을 명시적으로 등록해야 합니다:

• Qt Creator 의 경우, Qt Creator: Qt 버전 추가를 참조하십시오.
• Qt Extension for Visual Studio Code 의 경우 Qt Extension for Visual Studio Code: Qt 설치 등록을 참조하십시오.