Windows용 Qt - 소스에서 빌드하기

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

1단계: 소스 가져오기

Qt 소스는 Qt Online Installer 에서 설치할 수 있습니다. 소스 패키지는 Git, Qt 계정 (상용 사용자)의 아카이브, download.qt.io (오픈 소스 사용자)에서도 사용할 수 있습니다.

Qt Online Installer 을 통해 소스를 설치하면 Qt 설치 디렉토리(예: C:\Qt\6.8.2\Src)에서 사용할 수 있습니다.

소스 아카이브를 다운로드한 경우, 원하는 디렉토리(예: C:\dev\Qt\src)에 압축을 풉니다.

2단계: 빌드 요구 사항 설치 및 환경 설정하기

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

빌드 도구

cmake.exe, ninja.exe, python.exe 실행 파일은 빌드 환경에서 사용할 수 있어야 합니다. PATH 환경 변수에 해당 디렉터리를 추가합니다.

컴파일러

Qt 6.8에서 지원되는 컴파일러 및 구성은 다음과 같습니다:

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 삼중 항은 빌드 중인 Qt 버전을 나타냅니다. -prefix 옵션을 사용하여 변경할 수 있습니다. 추가로 조정하려면 Qt 구성 옵션 목록을 참조하십시오.

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

cmake --build . --parallel

--build 뒤의 마침표는 현재 폴더를 의미합니다.

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

cmake --install .

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

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

명령줄에서 작업하는 경우 다음과 같이 PATH 환경 변수에 Qt 도구를 추가하는 것이 좋습니다:

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

IDE에서 Qt를 사용하려는 경우, 여기에 명시적으로 Qt 버전을 등록해야 합니다. Qt Creator , Qt Creator: Qt 버전 추가하기를 참조하세요.