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

필수 조건

Qt를 빌드하려면 시스템에 macOS 플랫폼 SDK와 해당 툴체인이 설치되어 있어야 합니다. 빌드 환경에 설명된 대로 Xcode를 설치하면 이를 확보할 수 있습니다.

빌드하려는 구성에서 Qt가 테스트되었는지 확인하려면, ‘지원되는 구성’에 나열된 것과 정확히 동일한 Xcode 및 SDK 버전을 항상 사용해야 합니다.

Xcode 외에도 경로 PATH 에 다음 종속성이 포함되어 있는지 확인해야 합니다.

• CMake (>=3.25)
• Ninja

빌드하려면 Qt WebEngine 또는 Qt PDF를 빌드하려면 다음의 추가 종속성이 필요합니다:

• Python, html5lib
• Bison, Flex
• Gperf
• Node.js 버전 8 이상 (버전 12 권장)

QDoc 의존성

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

빌드 단계

다음 지침은 소스 패키지를 사용하여 Qt를 빌드하는 방법을 설명합니다. Qt 소스 코드는 ‘다운로드’ 페이지에서 다운로드할 수 있습니다. 자세한 내용은 ‘Qt 시작하기’ 페이지를 참조하십시오.

1단계: 아카이브 압축 해제

아직 아카이브를 압축 해제하지 않았다면 압축을 해제하십시오. 예를 들어, qt-everywhere-src-6.12.0.tar.xz 패키지가 있다면 명령줄 프롬프트에서 다음 명령을 입력하십시오:

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

그러면 아카이브의 파일이 포함된 /tmp/qt-everywhere-src-6.12.0 디렉터리가 생성됩니다.

2단계: Qt 라이브러리 빌드

사용 중인 시스템 유형에 맞게 Qt 라이브러리를 구성하려면 빌드 디렉터리를 생성하고 해당 디렉터리로 이동하십시오. 이 디렉터리에서 ` ./configure ` 스크립트를 실행하십시오.

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

기본적으로 Qt는 /usr/local/6.12.0 디렉터리에 설치되도록 구성되어 있지만, -prefix 옵션을 사용하여 이를 변경할 수 있습니다.

기본적으로 Qt는 프레임워크로 빌드되지만, -no-framework 옵션을 지정하여 일련의 동적 라이브러리(dylib)로 빌드할 수 있습니다.

'아키텍처' 섹션에서 설명한 바와 같이, Qt는 기본적으로 개발 머신의 아키텍처에 맞춰 빌드됩니다. Intel 및 Apple Silicon Mac을 모두 지원하는 Qt의 범용 빌드를 구성하려면 다음 인수를 추가하십시오:

./configure -- -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"

Intel 아키텍처("x86_64")를 먼저 지정해야 합니다. 그렇지 않으면 Qt가 모든 x86 기능을 활성화하지 못할 수 있습니다.

Qt는 디버깅 심볼과 함께 빌드되도록 구성할 수도 있습니다. 이 과정에 대한 자세한 내용은 '디버깅 기법' 문서에 설명되어 있습니다.

'Configure 옵션' 페이지에는 configure 옵션에 대한 자세한 정보가 포함되어 있습니다.

라이브러리를 생성하고 모든 예제 및 도구를 컴파일하려면 다음 명령을 입력하십시오:

cmake --build . --parallel

-prefix 가 빌드 디렉터리 외부에 있는 경우, 라이브러리, 예제 및 도구를 적절한 위치에 설치해야 합니다. 이를 위해 다음 명령을 입력하십시오:

cmake --install .

이 명령을 실행하려면 시스템에 관리자 권한이 있어야 합니다.

3단계: 환경 변수 설정

Qt를 사용하려면 일부 환경 변수를 설정해야 합니다.

PATH               - to locate qmake, moc and other Qt tools

방법은 다음과 같습니다:

.profile (셸이 bash인 경우) 또는 .zshenv (zsh인 경우) 파일에 다음 줄을 추가합니다:

PATH=/usr/local/Qt-%VERSION%/bin:$PATH
export PATH

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

setenv PATH /usr/local/Qt-%VERSION%/bin:$PATH

다른 셸을 사용하는 경우, 환경 변수를 그에 맞게 수정해 주십시오.

이제 Qt가 설치되었습니다.