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

이 페이지에서는 소스 코드를 사용하여 Linux용 Qt를 구성하고 빌드하는 방법을 설명합니다. 일반적으로 패키지 관리자를 통해 미리 빌드된 Qt 라이브러리와 도구를 설치하는 것이 더 쉽다는 점에 유의하십시오 Qt Online Installer를 통해 미리 빌드된 Qt 라이브러리와 도구를 설치하는 것이 일반적으로 더 쉽다는 점에 유의하십시오. 또한 많은 리눅스 배포판이 패키지 관리자를 통해 Qt 패키지를 제공합니다. 다만, Qt를 더 세밀하게 사용자 정의하고 싶거나 (적절한 버전의) 바이너리 Qt 패키지를 제공하지 않는 배포판을 사용하는 경우에는 소스 코드로부터 Qt를 빌드해야 합니다.

배포판 패키지 관리자는 ‘패키징 권장 사항’에서 Qt를 패키징하는 방법에 대한 자세한 정보를 확인할 수 있습니다.

1단계: 소스 코드 구하기

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

Qt Online Installer 를 통해 소스 코드를 설치하면, Qt 설치 디렉터리(예: $HOME/Qt/6.12.0/Src)에서 확인할 수 있습니다.

단일 소스 아카이브를 다운로드한 경우, 원하는 디렉터리에 압축을 풀어주세요:

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.12.0.tar.xz

2단계: 빌드 필수 구성 요소 설치

Qt를 빌드하려면 도구, 컴파일러 및 개발 패키지가 포함된 빌드 환경이 필요합니다.

빌드 도구

컴파일러 및 개발 패키지

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

다른 컴파일러나 구성으로도 작동할 수 있지만, 적극적으로 테스트되지는 않습니다.

또한 Qt는 다양한 라이브러리와 개발 패키지의 설치 여부에 의존하며, 이러한 패키지는 일반적으로 해당 배포판의 패키지 관리자를 통해 설치됩니다. 자세한 내용은 Qt for Linux - 요구 사항을 참조하십시오.

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

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

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.12.0/configure

기본적으로 Qt는 /usr/local/Qt-6.12.0 디렉터리에 설치되도록 구성되어 있습니다. -prefix 옵션을 사용하여 이 설정을 변경할 수 있습니다. 추가 조정이 필요하면 configure 옵션 목록을 참조하십시오.

configure 가 성공적으로 실행되었습니까? 그렇다면 라이브러리와 도구를 빌드하는 단계로 진행하십시오:

cmake --build . --parallel

빌드 후에는 라이브러리와 도구를 적절한 위치에 설치해야 합니다( 개발자용 빌드를 활성화한 경우는 제외):

cmake --install .

이 작업에는 루트 권한이 필요할 수 있습니다.

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

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

명령줄에서 작업하는 경우, Qt 도구를 기본 PATH 에 추가하는 것을 고려해 보십시오. 방법은 다음과 같습니다:

.profile 파일(셸이 bash, ksh, zsh 또는 sh인 경우)에 다음 줄을 추가하십시오:

PATH=/usr/local/Qt-6.12.0/bin:$PATH
export PATH

.login 파일에서(셸이 csh 또는 tcsh인 경우) 다음 한 줄을 추가하십시오:

setenv PATH /usr/local/Qt-6.12.0/bin:$PATH

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

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