Qt für macOS - Erstellung aus dem Quellcode

Anforderungen

Um Qt zu bauen, muss ein SDK für die macOS-Plattform und die entsprechende Toolchain auf dem System installiert sein. Sie erhalten diese durch die Installation von Xcode, wie in Qt für macOS#Bauumgebung beschrieben.

Sie sollten immer genau die gleiche Xcode- und SDK-Version verwenden, die in Qt für macOS#Unterstützte Versionen aufgeführt ist, um sicherzustellen, dass Qt in der Konfiguration, die Sie bauen, getestet wurde.

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

• CMake (>=3.16, >= 3.18.4 für Ninja Multi-Config, >= 3.21.1 für statische Qt-Builds oder das Bauen für Apple-Plattformen)
• Ninja

Wenn Sie bauen wollen Qt WebEngine oder Qt PDFbauen wollen, 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 bauen möchten, finden Sie unter Installieren von Clang für QDoc spezifische Build-Anforderungen.

Schritte zur Erstellung

Die folgenden Anweisungen beschreiben, wie Sie Qt aus dem Quellpaket bauen. Sie können die Qt-Quellen 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 zum Beispiel das Paket qt-everywhere-src-6.8.2.tar.xz haben, geben Sie die folgenden Befehle in eine Befehlszeile ein:

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

Dadurch wird das Verzeichnis /tmp/qt-everywhere-src-6.8.2 erstellt, das die Dateien des Archivs enthält.

Schritt 2: Erstellen Sie die Qt-Bibliothek

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

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

Standardmäßig ist Qt so konfiguriert, dass es im Verzeichnis /usr/local/6.8.2 installiert wird, aber dies kann mit der Option -prefix geändert werden.

Standardmäßig wird Qt als Framework gebaut, aber Sie können es auch als einen Satz dynamischer Bibliotheken (dylibs) bauen, indem Sie die Option -no-framework angeben.

Wie in Qt für macOS#Architekturen beschrieben, wird Qt standardmäßig für die Architektur Ihrer Entwicklungsmaschine gebaut. Um einen universellen Build von Qt mit Unterstützung für Intel und Apple Silicon Macs zu konfigurieren, fügen Sie das folgende Argument hinzu:

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

Achten Sie darauf, zuerst die Intel-Architektur ("x86_64") anzugeben, da Qt sonst möglicherweise nicht die gesamte x86-Funktionalität aktiviert.

Qt kann auch so konfiguriert werden, dass es mit Debugging-Symbolen gebaut wird. Dieser Prozess wird im Detail im Dokument Debugging-Techniken beschrieben.

Die Seite Configure Options enthält weitere Informationen über die Konfigurationsoptionen.

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

cmake --build . --parallel

Wenn sich -prefix außerhalb des Build-Verzeichnisses befindet, müssen Sie die Bibliothek, die Beispiele und die Tools an der entsprechenden Stelle installieren. Geben Sie dazu Folgendes ein:

cmake --install .

Dieser Befehl erfordert, dass Sie über Administratorrechte auf Ihrem Rechner verfügen.

Schritt 3: Setzen Sie die Umgebungsvariablen

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

PATH               - to locate qmake, moc and other Qt tools

Dies geschieht folgendermaßen:

Fügen Sie in .profile (wenn Ihre Shell bash ist) oder .zshenv (für zsh) die folgenden Zeilen ein:

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

In .login (falls Ihre Shell csh oder tcsh ist), fügen Sie die folgende Zeile hinzu:

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

Wenn Sie eine andere Shell verwenden, ändern Sie bitte Ihre Umgebungsvariablen entsprechend.

Qt ist nun installiert.