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

요구 사항

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

빌드 중인 구성에서 Qt가 테스트되었는지 확인하기 위해 항상 macOS용 Qt#지원 버전에 나열된 것과 동일한 Xcode 및 SDK 버전을 사용해야 합니다.

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

  • CMake (>=3.16, >= 3.18.4(Ninja Multi-Config의 경우), >= 3.21.1(정적 Qt 빌드 또는 Apple 플랫폼용 빌드의 경우)
  • Ninja

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

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

QDoc 종속성

QDoc은 Clang을 사용하여 C++ 코드를 구문 분석합니다. QDoc을 수동으로 빌드하려는 경우 구체적인 빌드 요구 사항은 QDoc용 Clang 설치하기를 참조하세요.

빌드 단계

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

1단계: 아카이브 압축 풀기

아직 압축을 풀지 않았다면 아카이브의 압축을 풉니다. 예를 들어 qt-everywhere-src-6.8.2.tar.xz 패키지가 있는 경우 명령줄 프롬프트에서 다음 명령을 입력합니다:

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

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

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

머신 유형에 맞게 Qt 라이브러리를 구성하려면 빌드 디렉터리를 생성하고 해당 디렉터리로 변경합니다. 이 디렉토리에서 ./configure 스크립트를 실행합니다.

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

참고: ninja 실행 파일을 사용할 수 있는 경우 구성은 항상 Ninja 생성기 및 빌드 도구를 사용합니다. Ninja는 크로스 플랫폼이며 기능이 풍부하고 성능이 뛰어나며 모든 플랫폼에서 사용할 것을 권장합니다. 다른 생성기를 사용할 수도 있지만 공식적으로 지원되지는 않습니다.

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

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

macOS용 Qt#아키텍처에 설명된 대로 Qt는 기본적으로 개발 머신의 아키텍처에 맞게 빌드됩니다. 인텔과 애플 실리콘 맥을 모두 지원하는 유니버설 빌드를 구성하려면 다음 인수를 추가합니다:

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

참고: 유니버설 빌드는 전체 빌드의 일부로 개발 머신에서 빌드되고 실행되는 툴에 의존하기 때문에 항상 개발 머신의 아키텍처를 포함해야 합니다.

인텔 아키텍처("x86_64")를 먼저 지정하지 않으면 Qt가 모든 x86 기능을 활성화하지 못할 수 있으므로 주의하십시오.

디버깅 심볼로 빌드하도록 Qt를 구성할 수도 있습니다. 이 과정은 디버깅 기 법 문서에 자세히 설명되어 있습니다.

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

라이브러리를 만들고 모든 예제와 도구를 컴파일하려면 다음과 같이 입력합니다:

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가 설치되었습니다.

© 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.