Qt für macOS – Kompilieren aus dem Quellcode

Voraussetzungen

Für die Kompilierung von Qt müssen ein macOS-Plattform-SDK und die entsprechende Toolchain auf dem System installiert sein. Diese erhalten Sie durch die Installation von Xcode, wie unter „Entwicklungsumgebung“ beschrieben.

Sie sollten stets genau dieselbe Xcode- und SDK-Version verwenden, wie sie unter „Unterstützte Konfigurationen“ aufgeführt ist, um sicherzustellen, dass Qt in der von Ihnen verwendeten Konfiguration getestet wurde.

Zusätzlich zu Xcode müssen Sie sicherstellen, dass die folgenden Abhängigkeiten in Ihrem Pfad „ PATH “ vorhanden sind.

• CMake (>=3.25)
• Ninja

Wenn Sie Qt WebEngine oder Qt PDFkompilieren möchten, benötigen Sie die folgenden zusätzlichen Abhängigkeiten:

• Python, html5lib
• Bison, Flex
• Gperf
• Node.js Version 8 oder höher (Version 12 empfohlen)

QDoc-Abhängigkeiten

QDoc verwendet Clang zum Parsen von C++-Code. Wenn Sie QDoc manuell kompilieren möchten, finden Sie unter „Installation von Clang für QDoc“ die spezifischen Kompilierungsanforderungen.

Schritte zum Kompilieren

Die folgenden Anweisungen beschreiben, wie Sie Qt aus dem Quellpaket kompilieren. Sie können die Qt-Quellcodes von der Seite „Downloads“ herunterladen. Weitere Informationen finden Sie auf der Seite „Erste Schritte mit Qt “.

Schritt 1: Entpacken des Archivs

Entpacken Sie das Archiv, falls Sie dies noch nicht getan haben. Wenn Sie beispielsweise das Paket „ qt-everywhere-src-6.12.0.tar.xz “ haben, geben Sie an der Befehlszeile folgende Befehle ein:

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

Dadurch wird das Verzeichnis „ /tmp/qt-everywhere-src-6.12.0 “ erstellt, das die Dateien aus dem Archiv enthält.

Schritt 2: Qt-Bibliothek erstellen

Um die Qt-Bibliothek für Ihren Rechnertyp zu konfigurieren, erstellen Sie ein Build-Verzeichnis und wechseln Sie dorthin. Führen Sie in diesem Verzeichnis das Skript „ ./configure “ aus.

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

Standardmäßig ist Qt für die Installation im Verzeichnis „ /usr/local/6.12.0 “ konfiguriert, dies kann jedoch mit der Option „ -prefix “ geändert werden.

Standardmäßig wird Qt als Framework kompiliert, Sie können es jedoch als eine Reihe dynamischer Bibliotheken (dylibs) kompilieren, indem Sie die Option „ -no-framework “ angeben.

Wie unter „Architekturen“ beschrieben, wird Qt standardmäßig für die Architektur Ihres Entwicklungsrechners kompiliert. Um einen universellen Build von Qt mit Unterstützung sowohl für Intel- als auch für Apple-Silicon-Macs zu konfigurieren, fügen Sie das folgende Argument hinzu:

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

Achten Sie darauf, die Intel-Architektur („x86_64“) an erster Stelle anzugeben, da Qt andernfalls möglicherweise nicht alle x86-Funktionen aktiviert.

Qt kann auch so konfiguriert werden, dass es mit Debugging-Symbolen erstellt wird. Dieser Vorgang wird im Dokument „Debugging-Techniken“ ausführlich beschrieben.

Die Seite „Konfigurationsoptionen“ enthält weitere Informationen zu den Konfigurationsoptionen.

Um die Bibliothek zu erstellen und alle Beispiele und Werkzeuge zu kompilieren, geben Sie Folgendes ein:

cmake --build . --parallel

Befindet sich „ -prefix “ außerhalb des Build-Verzeichnisses, müssen Sie die Bibliothek, die Beispiele und die Tools an einem geeigneten Ort installieren. Geben Sie dazu Folgendes ein:

cmake --install .

Für diesen Befehl benötigen Sie Administratorrechte auf Ihrem Rechner.

Schritt 3: Umgebungsvariablen setzen

Um Qt nutzen zu können, müssen einige Umgebungsvariablen erweitert werden.

PATH               - to locate qmake, moc and other Qt tools

Dies geschieht wie folgt:

Fügen Sie in der Datei „ .profile “ (wenn Ihre Shell „bash“ ist) oder in „ .zshenv “ (für „zsh“) die folgenden Zeilen hinzu:

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

Fügen Sie in „ .login “ (falls Ihre Shell csh oder tcsh ist) die folgende Zeile hinzu:

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

Wenn Sie eine andere Shell verwenden, passen Sie Ihre Umgebungsvariablen bitte entsprechend an.

Qt ist nun installiert.