Télécharger et installer Qt via l'interface en ligne de commande

Utilisez l'interface en ligne de commande avec Qt Online Installer et Qt Maintenance Tool pour installer, désinstaller, mettre à jour et rechercher des composants.

L'interface en ligne de commande prend en charge à la fois l'utilisation interactive et non interactive (utilisation sans intervention). Les rubriques suivantes fournissent des exemples et des informations sur la manière d'utiliser l'interface en ligne de commande :

• Téléchargement de Qt Online Installer via l’interface de ligne de commande
• Noms des composants à installer
• Installation sans intervention de 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 courantes
• Sélection d'un miroir pour Opensource
• Résumé de l'utilisation de l'interface en ligne de commande

Téléchargement de Qt Online Installer via l'interface en ligne de commande

Vous pouvez utiliser la commande « curl » dans l’interface en ligne de commande pour télécharger Qt Online Installer. Pour consulter tous les paquets Qt Online Installer disponibles pour différentes plateformes, rendez-vous sur Qt Online Installer official releases.

Pour télécharger un paquet Qt Online Installer spécifique portant le même nom que le fichier distant, utilisez l’option -O (avec un « O » majuscule).

La commande d’exemple ci-dessous permet de télécharger 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 à installer

Installation rapide avec des paquets d'alias

Au lieu de rechercher des noms de paquets spécifiques à installer, vous pouvez utiliser des paquets alias pour installer les configurations les plus courantes. Les paquets alias constituent un raccourci permettant d’inclure les paquets réels afin de faciliter l’installation.

Liste des paquets alias existants

Pour lister les paquets alias existants, utilisez la commande suivante dans l'interface en ligne de commande.

Utilisation de la commande « Qt Online Installer » :

<installer executable> search

Pour plus de détails sur les Qt Online Installer exécutables pour les différentes plateformes, consultez la section Installation avec interaction de l'utilisateur.

À l'aide d'Qt Maintenance Tool:

<maintenancetool executable> search

Pour plus d’informations sur les Qt Maintenance Tool exécutables pour les différentes plateformes, voir Installation avec intervention de l'utilisateur.

Contenu des paquets d'alias

Le contenu des paquets d'alias est répertorié dans le tableau ci-dessous.

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

Options d'alias de paquets pour Windows

Windows sur ARM64

Seuls les binaires MSVC (msvc2022-arm64) sont installés, car les autres paquets binaires Qt ne sont pas disponibles pour Windows sur ARM (WoA).

Windows sur x86_64

Par défaut, seuls les binaires MinGW sont installés.

Cependant, sous Windows sur x86_64, vous pouvez également installer des binaires pour les chaînes d'outils suivantes.

• llvm-mingw
• msvc2022
• msvc2022-arm64 (pour la compilation croisée)

Par exemple, l'utilisation du paquet alias qt6.12.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 correspondant « qt6.12.0-msvc2022-essentials ».

Liste des paquets sans alias

Pour lister les paquets non alias, utilisez la commande suivante dans l'interface en ligne de commande.

Utilisation de ` Qt Online Installer` :

<installer executable> search --type package

Pour plus de détails sur les Qt Online Installer exécutables pour les différentes plateformes, consultez la section Installation avec interaction de l’utilisateur.

Utilisation d'Qt Maintenance Tool:

<maintenancetool executable> search --type package

Pour plus de détails sur les Qt Maintenance Tool fichiers exécutables pour les différentes plateformes, voir Installation avec intervention de l'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 à l’aide de --filter-packages <regexp>. Par exemple, le filtrage en fonction du nom d'affichage peut faciliter la recherche.

Par exemple, la commande suivante permet de trouver tous les paquets MSVC 2022 pour Qt 6.12.0 :

search .*6120.*msvc2022

Vous obtenez le même résultat en filtrant les résultats de recherche comme suit :

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

Vous obtenez ainsi les paquets suivants :

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

Vous pouvez également utiliser le filtrage lorsque vous recherchez toutes les versions de Qt pour lesquelles un paquet est disponible. Par exemple, recherchez tous les paquets Qt Charts disponibles 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 intervention de l’utilisateur

Par défaut, Qt Online Installer ou Qt Maintenance Tool peuvent demander des informations supplémentaires pendant l’installation, ce qui nécessite l’intervention de l’utilisateur. Une installation sans intervention via l’interface de ligne de commande est possible en fournissant au préalable toutes les informations demandées à l’aide des options appropriées.

Nouvelle installation avec Qt Online Installer

Vous pouvez effectuer de nouvelles installations depuis l’interface en ligne de commande sans intervention de l’utilisateur comme suit :

1. Définissez l’ Qt Online Installer fichier exécutable.
2. Définissez le répertoire d'installation à l'aide de --root.
3. Utilisez la install <list of packages> commande avec les options d’installation sans intervention. Consultez la liste complète des options dans la section Options d’installation sans intervention.

Les exemples suivants montrent comment installer les binaires Qt 6.12.0 à l'aide de l'Qt Online Installer pour Windows, macOS et Linux. Les commandes en mode automatisé acceptent automatiquement les licences (--accept-licenses), répondent à toutes les demandes de confirmation par la 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.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

La section «Options pour une utilisation en mode silencieux » répertorie toutes les options disponibles pour une utilisation en mode silencieux.

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 intervention de l’utilisateur comme suit :

1. Définissez l’ Qt Maintenance Tool fichier exécutable.
2. Utilisez install <list of packages> avec les options d’utilisation sans intervention. Consultez la liste complète des options dans la section Options pour une utilisation sans intervention.

Les exemples suivants montrent comment ajouter les binaires Qt 6.12.0 avec Qt Maintenance Tool à une installation existante sous Windows, macOS et Linux. Les commandes en mode silencieux acceptent automatiquement les licences (--accept-licenses), répondent à toutes les demandes de confirmation par la 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.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

Options pour une utilisation sans intervention

Le tableau suivant répertorie toutes les options disponibles pour l'utilisation en mode silencieux depuis la ligne de commande :

Identifiants de message pour --auto-answer

Utilisez l’option « --auto-answer » pour fournir des réponses à certaines requêtes. Le tableau suivant répertorie les identifiants et les valeurs connus utilisés pour « --auto-answer » :

Fourniture des informations de connexion

Qt Online Installer et Qt Maintenance Tool imposent une connexion obligatoire. La connexion obligatoire utilise les informations contenues dans le fichier qtaccount.ini si celui-ci est disponible dans le cache. Vous trouverez le fichier qtaccount.ini comme suit :

Vous pouvez également vous connecter depuis la ligne de commande à l'aide des options correspondant à l'adresse e-mail et au 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 ce jeton dans le fichier qtaccount.ini.

Installation avec interaction de l'utilisateur

Vous pouvez utiliser l’interface en ligne de commande avec interaction de l’utilisateur comme suit :

1. Définissez l’exécutable :
   • Qt Online Installer si vous devez effectuer une nouvelle installation.
   • Qt Maintenance Tool si vous devez mettre à jour une installation existante.
2. Lors d'une nouvelle installation, définissez le répertoire d'installation à l'aide de --root
3. Utilisez install <list of packages> pour installer les paquets répertoriés.

Les exemples suivants montrent comment créer une nouvelle installation des binaires Qt 6.12.0 à l'aide de 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.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

Les exemples suivants montrent comment mettre à jour votre installation existante en installant les binaires Qt 6.12.0 à l'aide de Qt Maintenance Tool:

# 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

Désinstallation des paquets

L'interface en ligne de commande propose deux commandes pour désinstaller des paquets :

• La remove <list of packages> commande désinstalle les paquets répertoriés.
• La purge commande dé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écapitulatif des composants concernés par la commande. L'outil demande ensuite l'autorisation de poursuivre l'opération, afin d'éviter toute modification accidentelle. Utilisez --confirm-command pour ignorer la demande d’autorisation de poursuite.

L'exemple suivant désinstalle les binaires Qt 6.12.0 sans intervention de l'utilisateur :

# 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

Les exemples suivants désinstallent tous les paquets et demandent l'autorisation de poursuivre l'opération :

# Windows
MaintenanceTool.exe purge

# macOS
MaintenanceTool.dmg purge

# Linux
MaintenanceTool.run purge

Liste des paquets installés

La list commande répertorie tous les paquets que vous avez installés. Utilisez la commande avec l'Qt Maintenance Tool e comme suit :

# Windows
MaintenanceTool.exe list

# macOS
MaintenanceTool.dmg list

# Linux
MaintenanceTool.run list

Vérification des mises à jour

La check-updates commande 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 update commande met à jour les paquets installés. Utilisez la commande avec l'Qt Maintenance Tool e comme suit :

# windows
MaintenanceTool.exe update

# macOS
MaintenanceTool.dmg update

# linux
MaintenanceTool.run update

Commandes courantes

Utilisez la commande <installer_executable> --help pour découvrir les commandes et options disponibles. Voici les commandes les plus courantes :

Qt Installer Framework Le manuel fournit davantage 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 open source. Définissez le miroir depuis la ligne de commande à l’aide de l’ --mirror option.

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 uniquement la partie précédant « /online » (sans barre oblique à la fin).

Vous trouverez la liste des miroirs disponibles sur https://download.qt.io/online/qtsdkrepository/windows_x86/root/qt/Updates.xml.mirrorlist.

Résumé de l'utilisation de l'interface en ligne de commande

Qt Installer Framework Le manuel fournit des informations plus détaillées sur l'interface en ligne de commande :

• La section «Utilisation depuis la ligne de commande » décrit différents cas d'utilisation de l'interface en ligne de commande.
• La section «Résumé des options » répertorie toutes les options disponibles.
• La section «Résumé des commandes » répertorie toutes les commandes disponibles.