Linux/X11용 Qt - 소스에서 빌드하기
이 페이지에서는 소스에서 Linux/X11용 Qt를 구성하고 빌드하는 방법을 설명합니다. 일반적으로 미리 빌드된 Qt 라이브러리 및 도구를 설치하는 것이 Qt Online Installer. 또한 많은 리눅스 배포판은 패키지 관리자를 통해 Qt 패키지를 제공합니다. 그러나 Qt를 추가로 커스터마이징하거나 바이너리 Qt 패키지(올바른 버전)를 사용할 수 없는 배포판을 사용하는 경우 소스에서 Qt를 빌드하십시오.
배포판 패키저는 패키징 권장 사항에서 Qt 패키징 방법에 대한 자세한 정보를 찾을 수 있습니다.
1단계: 소스 가져오기
Qt 소스는 Qt Online Installer 에서 설치할 수 있습니다. 소스 패키지는 Git을 통해, Qt 계정 (상용 사용자)의 아카이브로, 다운로드.qt.io (오픈 소스 사용자)에서도 사용할 수 있습니다.
Qt Online Installer 을 통해 소스를 설치하면 Qt 설치 디렉토리(예: $HOME/Qt/6.8.2/Src
)에서 사용할 수 있습니다.
단일 소스 아카이브를 다운로드한 경우 원하는 디렉터리에 압축을 풉니다:
cd /tmp tar xf ~/Downloads/qt-everywhere-src-6.8.2.tar.xz
2단계: 빌드 요구 사항 설치
Qt를 빌드하려면 도구, 컴파일러 및 개발 패키지가 포함된 빌드 환경이 필요합니다.
빌드 도구
도구 | 지원 버전 |
---|---|
CMake | 버전 3.16 이상( -static 빌드의 경우 3.21 이상). |
Ninja | - |
Python | 버전 3 |
참고: ninja
실행 파일을 사용할 수 있는 경우 구성은 항상 Ninja 생성기 및 빌드 도구를 사용합니다. Ninja는 크로스 플랫폼이며 기능이 풍부하고 성능이 뛰어나며 모든 플랫폼에서 사용할 것을 권장합니다. 다른 생성기를 사용할 수도 있지만 공식적으로 지원되지는 않습니다.
컴파일러 및 개발 패키지
다음 컴파일러 및 구성은 Qt 6.8에서 지원됩니다:
배포 | 아키텍처 | 컴파일러 | 참고 |
---|---|---|---|
Red Hat 8.6 | x86_64 | GCC 10(도구 세트) | |
Red Hat 8.8 | x86_64 | GCC 10(도구 세트) | |
Red Hat 8.10 | x86_64 | GCC 10(도구 세트) | |
Red Hat 9.2 | x86_64 | GCC 11 | |
Red Hat 9.4 | x86_64 | GCC 11 | |
openSUSE 15.5 | x86_64 | GCC 9 | |
SUSE Linux 엔터프라이즈 서버 15 SP5 | x86_64 | GCC 10 | |
우분투 22.04 | x86_64 | Canonical에서 제공하는 GCC, GCC 11.x | |
우분투 24.04 | x86_64, arm64 | Canonical에서 제공한 GCC, GCC 13.x | 참고를 참조하세요. |
Debian 11.6 | x86_64, arm64 | GCC 10 | 기술 미리보기 참조: 엔터프라이즈 Qt 데비안 패키지. |
참고: 데스크톱용 Linux on Arm의 경우 8GB RAM이 장착된 Raspberry Pi 5 및 Ubuntu 24.04를 참조 플랫폼으로 사용합니다. 다른 하드웨어에 문제가 있는 경우 Raspberry Pi 5에서 문제를 재현해 보세요. 더 다양한 ARM 기반 데스크톱 하드웨어를 사용할 수 있게 되면 일반 플랫폼 지원으로 전환할 계획입니다.
다른 컴파일러와 구성은 작동할 수 있지만 적극적으로 테스트되지 않았습니다.
또한 Qt는 일반적으로 각 해상도의 패키지 관리자가 설치하는 다양한 라이브러리 및 개발 패키지의 가용성에 의존합니다. 자세한 내용은 X11용 Qt 요구 사항을 참조하십시오.
3단계: Qt 라이브러리 및 도구 빌드하기
빌드를 구성하려면 빌드 디렉터리를 생성하고 이 디렉터리에서 ./configure
스크립트를 실행합니다:
mkdir -p ~/dev/qt-build cd ~/dev/qt-build /tmp/qt-everywhere-src-6.8.2/configure
기본적으로 Qt는 /usr/local/Qt-6.8.2
디렉터리에 설치하도록 구성됩니다. -prefix
옵션을 사용하여 변경할 수 있습니다. 추가로 조정하려면 구성 옵션 목록을 참조하십시오.
configure
이 성공적으로 실행되었나요? 그런 다음 라이브러리 및 도구 빌드를 계속 진행하세요:
cmake --build . --parallel
빌드 후에는 적절한 위치에 라이브러리와 도구를 설치해야 합니다( 개발자 빌드를 활성화하지 않은 경우):
cmake --install .
이 경우 루트 액세스 권한이 필요할 수 있습니다.
4단계: 애플리케이션 빌드
Qt가 설치되면 애플리케이션 빌드를 시작할 수 있습니다.
명령줄에서 작업하는 경우 기본 PATH
에 Qt 도구를 추가하는 것이 좋습니다. 이 작업은 다음과 같이 수행됩니다:
.profile
(셸이 bash, ksh, zsh 또는 sh인 경우)에 다음 줄을 추가합니다:
PATH=/usr/local/Qt-6.8.2/bin:$PATH export PATH
.login
(셸이 csh 또는 tcsh인 경우)에 다음 줄을 추가합니다:
setenv PATH /usr/local/Qt-6.8.2/bin:$PATH
IDE에서 Qt를 사용하려는 경우, 여기에 Qt 버전을 명시적으로 등록해야 합니다. Qt Creator 의 경우 Qt Creator: 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.