Qt über die Befehlszeilenschnittstelle herunterladen und installieren

Verwenden Sie die Befehlszeilenschnittstelle mit Qt Online Installer und Qt Maintenance Tool, um Komponenten zu installieren, zu deinstallieren, zu aktualisieren und zu suchen.

Die Befehlszeilenschnittstelle unterstützt sowohl die interaktive als auch die nicht-interaktive Nutzung (unbeaufsichtigte Nutzung). Die folgenden Themen enthalten Beispiele und Informationen zur Verwendung der Befehlszeilenschnittstelle:

• Qt Online Installer mit der Befehlszeilenschnittstelle herunterladen
• Komponentennamen für die Installation
• Installation ohne Benutzereingriff
• Installation mit Benutzereingriff
• Deinstallieren von Paketen
• Auflistung installierter Pakete
• Nach Updates suchen
• Pakete aktualisieren
• Häufig verwendete Befehle
• Auswahl eines Spiegels für Open Source
• Zusammenfassung zur Verwendung der Befehlszeilenschnittstelle

Qt Online Installer über die Befehlszeilenschnittstelle herunterladen

Sie können den Befehl „ curl “ in der Befehlszeilenschnittstelle verwenden, um Qt Online Installer herunterzuladen. Um alle für verschiedene Plattformen verfügbaren Qt Online Installer -Pakete anzuzeigen, besuchen Sie die Seite mit den offiziellen Veröffentlichungen unterQt Online Installer .

Um ein bestimmtes „ Qt Online Installer “-Paket mit demselben Namen wie die Remote-Datei herunterzuladen, verwenden Sie die Option „ -O “ (Großbuchstabe „O“).

Der folgende Beispielbefehl lädt das Paket „ qt-online-installer-linux-x64-online.run “ herunter:

curl -OL https://download.qt.io/official_releases/online_installers/qt-online-installer-linux-x64-online.run

Komponentennamen für die Installation

Schnellinstallation mit Alias-Paketen

Anstatt nach bestimmten Paketnamen für die Installation zu suchen, können Sie Alias-Pakete verwenden, um die gängigsten Konfigurationen zu installieren. Alias-Pakete sind eine Abkürzung, um die eigentlichen Pakete einzubinden und so die Installation zu vereinfachen.

Vorhandene Alias-Pakete auflisten

Um die vorhandenen Alias-Pakete aufzulisten, verwenden Sie den folgenden Befehl in der Befehlszeilenschnittstelle.

Verwenden von „ Qt Online Installer “:

<installer executable> search

Einzelheiten zu den Qt Online Installer ausführbaren Dateien für verschiedene Plattformen finden Sie unter „Installation mit Benutzereingaben“.

Verwendung von „ Qt Maintenance Tool “:

<maintenancetool executable> search

Einzelheiten zu den Qt Maintenance Tool ausführbaren Dateien für verschiedene Plattformen finden Sie unter „Installation mit Benutzereingaben“.

Inhalt der Alias-Pakete

Der Inhalt der Alias-Pakete ist in der folgenden Tabelle aufgeführt.

Qt Online Installer Befehlsbeispiele

# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe install qt6.12.0-sdk

# macOS: new installation with Qt Online Installer
hdiutil attach qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg
/Volumes/qt-unified-macOS-x64-[Qt Online Installer version]-online/qt-unified-macOS-x64-[Qt Online Installer version]-online.app/Contents/MacOS/qt-unified-macOS-x64-[Qt Online Installer version]-online install qt6.12.0-sdk
hdiutil detach /Volumes/qt-unified-macOS-x64-[Qt Online Installer version]-online

# Linux: new installation with Qt Online Installer
qt-unified-linux-x64-[Qt Online Installer version]-online.run install qt6.12.0-sdk

Alias-Paketoptionen für Windows

Windows auf ARM64

Es werden ausschließlich die MSVC-Binärdateien (msvc2022-arm64) installiert, da andere Qt-Binärpakete für Windows auf ARM (WoA) nicht verfügbar sind.

Windows auf x86_64

Standardmäßig werden nur die MinGW-Binärdateien installiert.

Unter Windows auf x86_64 können Sie jedoch auch Binärdateien für die folgenden Toolchains installieren.

• llvm-mingw
• msvc2022
• msvc2022-arm64 (für die Cross-Kompilierung)

Verwendet man beispielsweise das Alias-Paket „qt6.12.0-essentials“, wird das Paket mit den standardmäßigen MinGW-Binärdateien installiert.

Um den Inhalt des Pakets „ Qt essentials “ beispielsweise mit den MSVC-2022-Binärdateien zu erhalten, verwenden Sie das entsprechende Alias-Paket „qt6.12.0-msvc2022-essentials “.

Auflisten von Nicht-Alias-Paketen

Um die Nicht-Alias-Pakete aufzulisten, verwenden Sie den folgenden Befehl in der Befehlszeilenschnittstelle.

Verwendung von „ Qt Online Installer “:

<installer executable> search --type package

Einzelheiten zu den Qt Online Installer ausführbaren Dateien für verschiedene Plattformen finden Sie unter „Installation mit Benutzereingaben“.

Verwendung von „ Qt Maintenance Tool “:

<maintenancetool executable> search --type package

Einzelheiten zu den Qt Maintenance Tool ausführbaren Dateien für verschiedene Plattformen finden Sie unter „Installation mit Benutzerinteraktion“.

Erweiterte Suche nach bestimmten Installationspaketen

Durchsuchen Sie die verfügbaren Pakete mit dem Befehl „ search “ und regulären Ausdrücken: search <regexp>. Sie können die Ergebnisse mit --filter-packages <regexp>. Beispielsweise kann das Filtern anhand der Anzeigenamen die Suche erleichtern.

Der folgende Befehl findet beispielsweise alle MSVC-2022-Pakete für Qt 6.12.0:

search .*6120.*msvc2022

Das gleiche Ergebnis erhalten Sie, wenn Sie das Suchergebnis wie folgt filtern:

search --filter-packages DisplayName=MSVC 2022,Version=6.12.0

Als Ergebnis erhalten Sie die folgenden Pakete:

<availablepackages>
    <package name="qt.qt6.6120.win64_msvc2022_64" displayname="MSVC 2022 64-bit" version="6.12.0.-0-<timestamp>"/>
    <package name="qt.qt6.6120.win64_msvc2022_arm64" displayname="MSVC 2022 ARM64" version="6.12.0.-0-<timestamp>"/>
</availablepackages>

Sie können die Filterfunktion auch nutzen, wenn Sie nach allen Qt-Versionen suchen, für die ein bestimmtes Paket bereitgestellt wird. Suchen Sie beispielsweise nach allen „ Qt Charts “-Paketen, die für Qt-Versionen bereitgestellt werden:

search --filter-packages DisplayName=charts

Das Suchergebnis sieht wie folgt aus:

<availablepackages>
    <package name="qt.qt5.5125.qtcharts" displayname="Qt Charts" version="5.12.5-0-<timestamp>"/>
    <package name="qt.qt6.641.addons.qtcharts" displayname="Qt Charts" version="6.4.1-0-<timestamp>"/>
    <package name="qt.qt5.5123.qtcharts" displayname="Qt Charts" version="5.12.3-0-<timestamp>"/>

Installation ohne Benutzereingriff

Standardmäßig fordern „ Qt Online Installer “ oder „ Qt Maintenance Tool “ während der Installation möglicherweise zusätzliche Informationen an, was die Aufmerksamkeit des Benutzers erfordert. Eine unbeaufsichtigte Installation über die Befehlszeilenschnittstelle ist möglich, indem alle angeforderten Informationen vorab mit entsprechenden Optionen bereitgestellt werden.

Neuinstallation mit Qt Online Installer

Sie können Neuinstallationen über die Befehlszeilenschnittstelle ohne Benutzereingriff wie folgt durchführen:

1. Definieren Sie die Qt Online Installer ausführbare Datei.
2. Legen Sie das Installationsverzeichnis mit --root.
3. Verwenden Sie den install <list of packages> Befehl mit Optionen für die unbeaufsichtigte Installation. Die vollständige Liste der Optionen finden Sie unter „Optionen für die unbeaufsichtigte Installation“.

Die folgenden Beispiele veranschaulichen, wie Sie Qt 6.12.0-Binärdateien mit „ Qt Online Installer “ für Windows, macOS und Linux installieren. Die Befehle für die automatische Installation akzeptieren automatisch die Lizenzen (--accept-licenses), beantworten alle Abfragen mit der Standardantwort (--default-answer) und überspringen die Abfrage nach der Erlaubnis zur Fortsetzung der Ausführung (--confirm-command):

# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe --root C:\Users\[username]\installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.6120.win64_msvc2022_64

# macOS: new installation with Qt Online Installer
qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg --root /home/<username>/installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.6120.clang_644

# linux: new installation with Qt Online Installer
qt-unified-linux-x64-[Qt Online Installer version]-online.run --root /home/<username>/installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.6120.linux_gcc_64

Unter„Optionen für die unbeaufsichtigte Ausführung “ sind alle verfügbaren Optionen für die unbeaufsichtigte Ausführung aufgeführt.

Aktualisierung der Installation mit Qt Maintenance Tool

Sie können eine bestehende Installation über die Befehlszeilenschnittstelle ohne Benutzereingriff wie folgt aktualisieren:

1. Definieren Sie die Qt Maintenance Tool ausführbare Datei.
2. Verwenden Sie install <list of packages> mit Optionen für den unbeaufsichtigten Betrieb. Die vollständige Liste der Optionen finden Sie unter „Optionen für den unbeaufsichtigten Betrieb“.

Die folgenden Beispiele veranschaulichen, wie Sie Qt 6.12.0-Binärdateien mit „ Qt Maintenance Tool “ zu einer bestehenden Installation unter Windows, macOS und Linux hinzufügen. Die Befehle für die automatische Installation akzeptieren automatisch die Lizenzen (--accept-licenses), beantworten alle Abfragen mit der Standardantwort (--default-answer) und überspringen die Abfrage nach der Erlaubnis zur Fortsetzung der Ausführung (--confirm-command):

# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe --accept-licenses --default-answer --confirm-command install qt.qt6.6120.win64_msvc2022_64

# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.app/Contents/MacOS/MaintenanceTool --accept-licenses --default-answer --confirm-command install qt.qt6.6120.clang_64

# linux: update installation with Qt Maintenance Tool
MaintenanceTool.run --accept-licenses --default-answer --confirm-command install qt.qt6.6120.linux_gcc_64

Optionen für den unbeaufsichtigten Einsatz

Die folgende Tabelle listet alle Optionen für die unbeaufsichtigte Befehlszeilenverwendung auf:

Meldungskennungen für --auto-answer

Verwenden Sie die Option „ --auto-answer “, um Antworten auf bestimmte Abfragen bereitzustellen. Die folgende Tabelle listet bekannte Bezeichner und Werte auf, die für „ --auto-answer “ verwendet werden:

Bereitstellung von Anmeldeinformationen

Qt Online Installer und Qt Maintenance Tool erfordern eine erzwungene Anmeldung. Die erzwungene Anmeldung verwendet Informationen aus der Datei „qtaccount.ini“, sofern diese im Cache verfügbar ist. Sie finden „qtaccount.ini“ wie folgt:

Optional können Sie sich über die Befehlszeile mit den Schaltern für E-Mail und Passwort anmelden: --email <your_email> und --pw <your_pw>.

Alternativ können Sie das JWT-Token in der Umgebungsvariable ` QT_INSTALLER_JWT_TOKEN` speichern. Das Token finden Sie in der Datei `qtaccount.ini `.

Installation mit Benutzerinteraktion

Sie können die Befehlszeilenschnittstelle mit Benutzereingaben wie folgt verwenden:

1. Definieren Sie die ausführbare Datei:
   • Qt Online Installer wenn Sie eine Neuinstallation durchführen müssen.
   • Qt Maintenance Tool wenn Sie eine bestehende Installation aktualisieren müssen.
2. Bei einer Neuinstallation legen Sie das Installationsverzeichnis mit --root
3. Verwenden Sie install <list of packages> , um die aufgeführten Pakete zu installieren.

Die folgenden Beispiele zeigen, wie Sie eine neue Installation der Qt 6.12.0-Binärdateien mit „ Qt Online Installer “ für Windows, macOS und Linux erstellen:

# Windows: new installation with user interaction
qt-unified-windows-x64-[Qt Online Installer version]-online.exe --root C:\Users\[username]\installation_dir install qt.qt6.6120.win64_msvc2022_64

# macOS: new installation with user interaction
qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg --root /home/<username>/installation_dir install qt.qt6.6120.clang_64

# linux: new installation with user interaction
qt-unified-linux-x64-[Qt Online Installer version]-online.run --root /home/<username>/installation_dir install qt.qt6.6120.linux_gcc_64

Die folgenden Beispiele zeigen, wie Sie Ihre bestehende Installation aktualisieren, indem Sie die Qt 6.12.0-Binärdateien mit „ Qt Maintenance Tool “ installieren:

# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe install qt.qt6.6120.win64_msvc2022_64

# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.dmg install qt.qt6.6120.clang_64

# Linux: update installation with Qt Maintenance Tool
MaintenanceTool.run install qt.qt6.6120.linux_gcc_64

Pakete deinstallieren

Die Befehlszeilenschnittstelle bietet zwei Befehle zum Deinstallieren von Paketen:

• Der remove <list of packages> Befehl deinstalliert die aufgeführten Pakete.
• Der purge Befehl deinstalliert alle installierten Pakete.

Sie sollten beide Befehle mit „ Qt Maintenance Tool “ verwenden.

Standardmäßig gibt „ Qt Maintenance Tool “ eine Übersicht über die vom Befehl betroffenen Komponenten aus. Anschließend fragt das Tool nach der Erlaubnis, fortzufahren, um versehentliche Änderungen zu verhindern. Verwenden Sie --confirm-command , um die Abfrage zur Fortsetzung zu überspringen.

Das folgende Beispiel deinstalliert die Qt 6.12.0-Binärdateien ohne Benutzereingriff:

# windows
MaintenanceTool.exe --confirm-command remove qt.qt6.6120.win64_msvc2022_64

# macOS
MaintenanceTool.dmg --confirm-command remove install qt.qt6.6120.clang_64

# linux
MaintenanceTool.run --confirm-command remove qt.qt6.6120.linux_gcc_64

Die folgenden Beispiele deinstallieren alle Pakete und fragen nach der Erlaubnis, die Aktion fortzusetzen:

# Windows
MaintenanceTool.exe purge

# macOS
MaintenanceTool.dmg purge

# Linux
MaintenanceTool.run purge

Installierte Pakete auflisten

Der list Befehl listet alle von Ihnen installierten Pakete auf. Verwenden Sie den Befehl mit „ Qt Maintenance Tool “ wie folgt:

# Windows
MaintenanceTool.exe list

# macOS
MaintenanceTool.dmg list

# Linux
MaintenanceTool.run list

Auf Updates prüfen

Der check-updates Befehl prüft, ob Updates für die installierten Pakete verfügbar sind. Verwenden Sie den Befehl mit „ Qt Maintenance Tool “ wie folgt:

# Windows
MaintenanceTool.exe check-updates

# macOS
MaintenanceTool.dmg check-updates

# Linux
MaintenanceTool.run check-updates

Pakete aktualisieren

Der update Befehl aktualisiert die installierten Pakete. Verwenden Sie den Befehl mit „ Qt Maintenance Tool “ wie folgt:

# windows
MaintenanceTool.exe update

# macOS
MaintenanceTool.dmg update

# linux
MaintenanceTool.run update

Häufig verwendete Befehle

Verwenden Sie den Befehl <installer_executable> --help , um sich über die verfügbaren Befehle und Optionen zu informieren. Hier sind einige häufig verwendete Befehle:

Qt Installer Framework Das Handbuch enthält weitere Informationen zu den Befehlen und Optionen.

Auswahl eines Spiegels für OpenSource

Qt Online Installer verfügt über eine Option zur Auswahl eines Spiegels für Open-Source-Metadaten und -Downloads. Legen Sie den Spiegel über die Befehlszeile mit der --mirror Option ein.

Verwenden Sie beispielsweise „ --mirror “ wie folgt:

installer(.exe) --mirror http://www.nic.funet.fi/pub/mirrors/download.qt-project.org
installer(.exe) --mirror http://ftp2.nluug.nl/languages/qt
maintenancetool(.exe) --mirror http://qt.mirror.constant.com

Wie das Beispiel zeigt, verwenden Sie nicht den vollständigen Pfad, sondern den Pfad vor „/online“ (ohne Schrägstrich am Ende).

Die verfügbaren Spiegel finden Sie unter https://download.qt.io/online/qtsdkrepository/windows_x86/root/qt/Updates.xml.mirrorlist.

Zusammenfassung zur Verwendung der Befehlszeilenschnittstelle

Qt Installer Framework Das Handbuch enthält detailliertere Informationen zur Befehlszeilenschnittstelle:

• Unter „Verwendung über die Befehlszeile “ werden verschiedene Anwendungsfälle für die Befehlszeilenschnittstelle beschrieben.
• Unter„Übersicht über die Optionen “ sind alle verfügbaren Optionen aufgeführt.
• „Übersicht über die Befehle “ listet alle verfügbaren Befehle auf.