Obtenir et installer Qt avec l'interface de ligne de commande
Utilisez l'interface de ligne de commande avec Qt Online Installer et Qt Maintenance Tool pour installer, désinstaller, mettre à jour et rechercher des composants.
L'interface de ligne de commande prend en charge l'utilisation interactive et non interactive (utilisation sans surveillance). Les rubriques suivantes fournissent des exemples et des informations sur l'utilisation de l'interface de ligne de commande :
- Téléchargement de Qt Online Installer avec l'interface de ligne de commande
- Noms des composants pour l'installation
- Installation sans interaction avec l'utilisateur
- Installation avec interaction de l'utilisateur
- Désinstallation des paquets
- Liste des paquets installés
- Vérification des mises à jour
- Mise à jour des paquets
- Commandes populaires
- Sélection d'un miroir pour Opensource
- Résumé de l'utilisation de l'interface de ligne de commande
Téléchargement de Qt Online Installer avec l'interface de ligne de commande
Vous pouvez utiliser la commande curl dans l'interface de ligne de commande pour télécharger Qt Online Installer. Pour voir tous les paquets Qt Online Installer disponibles pour différentes plateformes, visitez Qt Online Installer official releases.
Pour télécharger un paquetage Qt Online Installer spécifique portant le même nom que le fichier distant, utilisez l'option -O (O majuscule).
L'exemple de commande ci-dessous télécharge le paquet qt-online-installer-linux-x64-online.run:
curl -OL https://download.qt.io/official_releases/online_installers/qt-online-installer-linux-x64-online.run
Noms des composants pour l'installation
Installation rapide avec des paquets alias
Au lieu de rechercher des noms de paquets spécifiques pour l'installation, vous pouvez utiliser des alias de paquets pour installer les configurations les plus courantes. Les paquets alias sont un raccourci pour inclure les paquets réels afin de faciliter l'installation.
Liste des paquets alias existants
Pour dresser la liste des paquets alias existants, utilisez la commande suivante dans l'interface de ligne de commande.
Utilisation de Qt Online Installer:
<installer executable> search
Pour plus de détails sur les Qt Online Installer pour les différentes plates-formes, voir Installation avec interaction de l'utilisateur.
Utilisation de Qt Maintenance Tool:
<maintenancetool executable> search
Pour plus de détails sur les Qt Maintenance Tool pour différentes plates-formes, voir Installation avec interaction utilisateur.
Contenu des paquets d'alias
Le contenu des paquets alias est listé dans le tableau ci-dessous.
Remarque : la version 6.11.0 de Qt est utilisée dans les exemples de paquets d'alias énumérés ci-dessous. N'oubliez pas de toujours utiliser les paquets correspondant à la version de Qt sur laquelle vous travaillez.
| Nom du paquet alias | Qt Online Installer (contenu du paquet) |
|---|---|
| qt6.11.0-essentials |
|
| qt6.11.0-essentials-dev |
|
| qt6.11.0-full |
|
| qt6.11.0-full-dev |
|
| qt6.11.0-full-dbg |
|
| qt6.11.0-sdk |
|
Qt Online Installer exemples de commandes
# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe install qt6.11.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.11.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.11.0-sdkOptions du paquet Alias pour Windows
Note : Les informations de cette section sont valables pour les versions Qt 6.8, Qt 6.9, et Qt 6.10.
Windows sur ARM64
Seuls les binaires MSVC (msvc2022-arm64) sont installés car les autres paquets binaires Qt ne sont pas disponibles pour Windows on Arm (WoA).
Windows sur x86_64
Par défaut, seuls les binaires MinGW sont installés.
Cependant, avec Windows sur x86_64, vous pouvez également installer les binaires pour les chaînes d'outils suivantes.
- llvm-mingw
- msvc2022
- msvc2022-arm64 (pour la compilation croisée)
L'utilisation, par exemple, du paquet alias qt6.11.0-essentials installe le paquet avec les binaires MinGW par défaut.
Pour obtenir le contenu du paquet Qt essentials avec, par exemple, les binaires MSVC 2022, utilisez le paquet alias qt6.11.0-msvc2022-essentials correspondant.
Liste des paquets sans alias
Pour dresser la liste des paquets sans alias, utilisez la commande suivante dans l'interface de ligne de commande.
Utilisation de Qt Online Installer:
<installer executable> search --type package
Pour plus de détails sur les Qt Online Installer pour les différentes plates-formes, voir Installation avec interaction de l'utilisateur.
Utilisation de Qt Maintenance Tool:
<maintenancetool executable> search --type package
Pour plus de détails sur les Qt Maintenance Tool pour différentes plates-formes, voir Installation avec interaction utilisateur.
Recherche avancée de paquets d'installation spécifiques
Recherchez les paquets disponibles à l'aide de la commande search et d'expressions régulières : search <regexp>. Vous pouvez filtrer les résultats avec --filter-packages <regexp>. Par exemple, le filtrage à l'aide du nom d'affichage peut faciliter la recherche.
Par exemple, la commande suivante permet de trouver tous les paquets MSVC 2022 pour Qt 6.11.0 :
search .*6111.*msvc2022
Vous obtenez le même résultat si vous filtrez le résultat de la recherche comme suit :
search --filter-packages DisplayName=MSVC 2022,Version=6.11.0
Vous obtenez alors les paquets suivants :
<availablepackages>
<package name="qt.qt6.6111.win64_msvc2022_64" displayname="MSVC 2022 64-bit" version="6.11.0.-0-<timestamp>"/>
<package name="qt.qt6.6111.win64_msvc2022_arm64" displayname="MSVC 2022 ARM64" version="6.11.0.-0-<timestamp>"/>
</availablepackages>Vous pouvez également utiliser le filtrage lorsque vous recherchez toutes les versions de Qt pour lesquelles un paquetage est fourni. Par exemple, recherchez tous les paquets Qt Charts fournis pour les versions de Qt :
search --filter-packages DisplayName=charts
Le résultat de la recherche est le suivant :
<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 sans interaction avec l'utilisateur
Par défaut, Qt Online Installer ou Qt Maintenance Tool peut demander des informations supplémentaires lors de l'installation, ce qui requiert l'attention de l'utilisateur. L'utilisation sans surveillance via l'interface de ligne de commande est possible en fournissant toutes les informations demandées au préalable avec les options appropriées.
Nouvelle installation avec Qt Online Installer
Vous pouvez effectuer de nouvelles installations à partir de l'interface de ligne de commande sans interaction avec l'utilisateur, comme suit :
- Définissez l'exécutable Qt Online Installer exécutable.
- Définir le répertoire d'installation avec
--root. - Utilisez la commande
install <list of packages>avec des options pour une utilisation sans surveillance. Voir la liste complète des options dans Options for Unattended Usage.
Les exemples suivants montrent comment installer les binaires de Qt 6.11.0 avec Qt Online Installer pour Windows, macOS et Linux. Les commandes sans surveillance acceptent automatiquement les licences (--accept-licenses), répondent à toutes les requêtes de messages avec leur réponse par défaut (--default-answer) et ne demandent pas l'autorisation de poursuivre l'exécution (--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.6111.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.6111.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.6111.linux_gcc_64La sectionOptions pour l'utilisation sans surveillance énumère toutes les options disponibles pour l'utilisation sans surveillance.
Mise à jour de l'installation avec Qt Maintenance Tool
Vous pouvez mettre à jour une installation existante à partir de l'interface de ligne de commande, sans interaction avec l'utilisateur, en procédant comme suit :
- Définissez l'exécutable Qt Maintenance Tool Définir l'exécutable.
- Utiliser
install <list of packages>avec des options pour une utilisation sans surveillance. Voir la liste complète des options dans Options for Unattended Usage.
Les exemples suivants montrent comment ajouter les binaires Qt 6.11.0 avec Qt Maintenance Tool à une installation exsting sur Windows, macOS et Linux. Les commandes sans surveillance acceptent automatiquement les licences (--accept-licenses), répondent à toutes les demandes de messages avec leur réponse par défaut (--default-answer) et ne demandent pas l'autorisation de poursuivre l'exécution (--confirm-command) :
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe --accept-licenses --default-answer --confirm-command install qt.qt6.6111.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.app/Contents/MacOS/MaintenanceTool --accept-licenses --default-answer --confirm-command install qt.qt6.6111.clang_64
# linux: update installation with Qt Maintenance Tool
MaintenanceTool.run --accept-licenses --default-answer --confirm-command install qt.qt6.6111.linux_gcc_64Options pour l'utilisation sans surveillance
Le tableau suivant répertorie toutes les options pour l'utilisation de la ligne de commande sans surveillance :
| Option pour l'utilisation sans surveillance | Description de l'option |
|---|---|
--accept-licenses | Accepte automatiquement tous les accords de licence. |
--accept-obligations | Dans les installations opensource, accepte les obligations d'utilisation de Qt Open Source sans intervention de l'utilisateur. |
--default-answer | Répond à toutes les demandes de messages par leur réponse par défaut. |
--auto-answer <identifier=value> | Si vous souhaitez des réponses différentes à certaines questions, vous pouvez utiliser cette option. Par exemple, --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes. Voir tous les identificateurs de messages dans Identificateurs de messages pour --auto-answer. |
--accept-messages | Accepte toutes les demandes de messages. |
--reject-messages | Rejette toutes les demandes de messages. |
--confirm-command | Par défaut, Qt Online Installer et Qt Maintenance Tool affichent un résumé des composants concernés par l'option. Ils demandent ensuite la permission de continuer à agir, afin d'éviter les modifications accidentelles. Cette option permet de ne pas demander l'autorisation de continuer. |
--email <your_email> | Fournit le courriel lorsque vous vous connectez à partir de la ligne de commande. Pour plus d'informations, voir Fournir des informations de connexion. |
--pw <your_pw> | Fournit le mot de passe lorsque vous vous connectez à partir de la ligne de commande. Pour plus d'informations, voir Fournir des informations de connexion. |
--file-query <identifier=value> | Parfois, Qt Online Installer demande l'emplacement d'un fichier ou d'un dossier. Vous pouvez fournir l'emplacement avec --file-query <identifier=value>. Par exemple, --file-query PathForSDP7=<path_to_sdp>.Les identifiants sont imprimés dans la ligne de commande avant la question proprement dite et le type de message. Vous pouvez récupérer les identifiants à partir de là. |
Identifiants de message pour --auto-answer
L'option --auto-answer permet de répondre à certaines questions. Le tableau suivant répertorie les identificateurs connus et les valeurs utilisées pour --auto-answer:
| ID | Valeurs | Valeur par défaut |
|---|---|---|
| Erreur OperationDoesNotExistError | Abandonner, Ignorer | Ignorer |
| Écraser le répertoire cible | Oui, Non | Non |
| stopProcessesForUpdates | Réessayer, Ignorer, Annuler | Annuler |
| installationErrorWithCancel | Réessayer, Ignorer, Annuler | Annuler |
| installationErrorWithIgnore | Réessayer, Ignorer | Ignorer |
| AssociateCommonFiletypes | Oui, Non | Oui |
| telemetry-question | Oui, Non | Oui |
Fournir des informations de connexion
Qt Online Installer et Qt Maintenance Tool ont une connexion forcée. La connexion forcée utilise les informations du fichier qtaccount.ini s'il est disponible dans le cache. Le fichier qtaccount.ini se trouve comme suit :
| Hôte | Emplacement de qtaccount.ini |
|---|---|
| Windows | C:\Users\<username>\AppData\Roaming\Qt |
| macOS | /Users/<username>/Library/Application Support/Qt/qtaccount.ini |
| Linux | /home/<username>/.local/share/Qt/qtaccount.ini |
En option, vous pouvez vous connecter à partir de la ligne de commande en utilisant les commutateurs pour l'email et le mot de passe : --email <your_email> et --pw <your_pw>.
Vous pouvez également enregistrer le jeton jwt dans la variable d'environnement QT_INSTALLER_JWT_TOKEN. Vous trouverez le jeton dans le fichier qtaccount.ini.
Installation avec l'interaction de l'utilisateur
Vous pouvez utiliser l'interface de ligne de commande avec l'interaction de l'utilisateur comme suit :
- Définissez l'exécutable :
- Qt Online Installer si vous devez faire une nouvelle installation.
- Qt Maintenance Tool si vous devez mettre à jour une installation existante.
- Lors d'une nouvelle installation, définissez le répertoire d'installation à l'aide de la commande
--root - Utiliser
install <list of packages>pour installer les paquets listés.
Les exemples suivants montrent comment créer une nouvelle installation des binaires Qt 6.11.0 avec Qt Online Installer pour Windows, macOS et Linux :
# 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.6111.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.6111.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.6111.linux_gcc_64
Les exemples suivants montrent comment vous mettez à jour votre installation existante en installant les binaires Qt 6.11.0 avec Qt Maintenance Tool:
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe install qt.qt6.6111.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.dmg install qt.qt6.6111.clang_64
# Linux: update installation with Qt Maintenance Tool
MaintenanceTool.run install qt.qt6.6111.linux_gcc_64Désinstallation des paquets
L'interface de ligne de commande fournit deux commandes pour désinstaller les paquets :
- La commande
remove <list of packages>désinstalle les paquets listés. - La commande
purgedésinstalle tous les paquets installés.
Vous devez utiliser ces deux commandes avec Qt Maintenance Tool.
Par défaut, Qt Maintenance Tool affiche un résumé des composants qui seront affectés par la commande. L'outil demande ensuite la permission de poursuivre l'action, afin d'éviter toute modification accidentelle. Utilisez la commande --confirm-command pour ne pas demander l'autorisation de continuer.
L'exemple suivant désinstalle les binaires Qt 6.11.0 sans interaction de l'utilisateur :
# windows MaintenanceTool.exe --confirm-command remove qt.qt6.6111.win64_msvc2022_64 # macOS MaintenanceTool.dmg --confirm-command remove install qt.qt6.6111.clang_64 # linux MaintenanceTool.run --confirm-command remove qt.qt6.6111.linux_gcc_64
Les exemples suivants désinstallent tous les paquets et demandent l'autorisation de poursuivre l'action :
# Windows MaintenanceTool.exe purge # macOS MaintenanceTool.dmg purge # Linux MaintenanceTool.run purge
Liste des paquets installés
La commande list permet d'obtenir la liste de tous les paquets installés. Utilisez la commande avec Qt Maintenance Tool comme suit :
# Windows MaintenanceTool.exe list # macOS MaintenanceTool.dmg list # Linux MaintenanceTool.run list
Vérification des mises à jour
La commande check-updates vérifie les mises à jour disponibles pour les paquets installés. Utilisez la commande avec Qt Maintenance Tool comme suit :
# Windows MaintenanceTool.exe check-updates # macOS MaintenanceTool.dmg check-updates # Linux MaintenanceTool.run check-updates
Mise à jour des paquets
La commande update met à jour les paquets installés. Utilisez la commande avec Qt Maintenance Tool comme suit :
# windows MaintenanceTool.exe update # macOS MaintenanceTool.dmg update # linux MaintenanceTool.run update
Commandes populaires
Utilisez la commande <installer_executable> --help pour étudier les commandes et options disponibles. Les commandes les plus courantes sont les suivantes :
| Commande | Utilisation |
|---|---|
in, install <pkg ...> | Installe les paquets donnés en argument. Si vous ne donnez aucun paquet, l'ensemble des paquets par défaut est installé. |
rm, remove <pkg ...> | Désinstalle les paquets sélectionnés et leurs composants enfants. |
ch, check-updates | Affiche des informations sur les mises à jour disponibles sur Qt Maintenance Tool. |
up, update <pkg ...> | Met à jour les paquets donnés en argument. Si aucun paquet n'est fourni, toutes les mises à jour disponibles sont installées. |
se, search <regexp> | Recherche les paquets disponibles. Si vous n'indiquez aucun critère de recherche, tous les paquets disponibles sont affichés. Vous pouvez utiliser l'option --filter-packages pour spécifier des filtres supplémentaires pour l'opération de recherche. Voir le résumé des options dans le manuel Qt Installer Framework. |
Qt Installer Framework Lemanuel fournit plus d'informations sur les commandes et les options.
Sélection d'un miroir pour Opensource
Qt Online Installer dispose d'une option permettant de sélectionner un miroir pour les métadonnées et les téléchargements opensource. Vous pouvez définir le miroir à partir de la ligne de commande à l'aide de l'option --mirror à partir de la ligne de commande.
Par exemple, utilisez --mirror comme suit :
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
Comme le montre l'exemple, n'utilisez pas le chemin d'accès complet, mais le chemin d'accès précédant '/online' (sans barre oblique à la fin).
Vous trouverez les miroirs disponibles à partir de https://download.qt.io/online/qtsdkrepository/windows_x86/root/qt/Updates.xml.mirrorlist.
Résumé de l'utilisation de l'interface de ligne de commande
Qt Installer Framework Lemanuel fournit des informations plus détaillées sur l'interface de ligne de commande :
- Utilisation de la ligne de commande décrit les différents cas d'utilisation de l'interface de ligne de commande.
- Lerésumé des options énumère toutes les options disponibles.
- Résumé des commandes liste toutes les commandes disponibles.
© 2026 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.
