Obtener e instalar Qt con la interfaz de línea de comandos
Utilice la interfaz de línea de comandos con Qt Online Installer y Qt Maintenance Tool para instalar, desinstalar, actualizar y buscar componentes.
La interfaz de línea de comandos admite tanto el uso interactivo como el no interactivo (uso desatendido). Los siguientes temas proporcionan ejemplos e información sobre cómo puede utilizar la interfaz de línea de comandos:
- Descarga de Qt Online Installer con la interfaz de línea de comandos
- Nombres de componentes para la instalación
- Instalación sin interacción del usuario
- Instalación con intervención del usuario
- Desinstalación de paquetes
- Listado de paquetes instalados
- Comprobación de actualizaciones
- Actualización de paquetes
- Comandos populares
- Selección de Mirror para Opensource
- Resumen del uso de la interfaz de línea de comandos
Descarga de Qt Online Installer con la interfaz de línea de comandos
Puede utilizar el comando curl en la interfaz de línea de comandos para descargar Qt Online Installer. Para ver todos los paquetes Qt Online Installer disponibles para diferentes plataformas, visite Qt Online Installer official releases.
Para descargar un paquete Qt Online Installer específico con el mismo nombre que el archivo remoto, utilice la opción -O (O mayúscula).
El siguiente comando de ejemplo descarga el paquete qt-online-installer-linux-x64-online.run:
curl -OL https://download.qt.io/official_releases/online_installers/qt-online-installer-linux-x64-online.run
Nombres de componentes para la instalación
Instalación rápida con paquetes alias
En lugar de buscar nombres de paquetes específicos para la instalación, puede utilizar paquetes alias para instalar las configuraciones más comunes. Los paquetes alias son un atajo para incluir los paquetes reales y facilitar la instalación.
Listado de paquetes alias existentes
Para listar los paquetes alias existentes, utilice el siguiente comando en la interfaz de línea de comandos.
Uso de Qt Online Installer:
<installer executable> search
Para obtener más información sobre los Qt Online Installer ejecutables para diferentes plataformas, consulte Instalación con interacción del usuario.
Mediante Qt Maintenance Tool:
<maintenancetool executable> search
Para obtener más información sobre los Qt Maintenance Tool para diferentes plataformas, consulte Instalación con interacción del usuario.
Contenido de los paquetes alias
Los contenidos de los paquetes alias se enumeran en la siguiente tabla.
Nota: La versión Qt 6.11.0 se utiliza en los ejemplos de paquetes alias que se muestran a continuación. Recuerde siempre usar los paquetes que coincidan con la versión de Qt en la que esté trabajando.
| Nombre del paquete alias | Qt Online Installer (contenido del paquete) |
|---|---|
| qt6.11.0-esenciales |
|
| 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 ejemplos de comandos
# 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-sdkOpciones de paquetes Alias para Windows
Nota: La información de esta sección es válida para las versiones Qt 6.8, Qt 6.9 y Qt 6.10.
Windows en ARM64
Sólo se instalan los binarios MSVC (msvc2022-arm64) ya que otros paquetes binarios Qt no están disponibles para Windows en Arm (WoA).
Windows en x86_64
Por defecto, sólo se instalan los binarios MinGW.
Sin embargo, con Windows en x86_64 también puede instalar binarios para las siguientes cadenas de herramientas.
- llvm-mingw
- msvc2022
- msvc2022-arm64 (para compilación cruzada)
Utilizando, por ejemplo, el paquete alias qt6.11.0-essentials se instala el paquete con los binarios MinGW por defecto.
Para obtener el contenido del paquete Qt essentials con, por ejemplo, los binarios MSVC 2022, utilice el paquete de alias qt6.11.0-msvc2022-essentials correspondiente.
Listado de paquetes sin alias
Para listar los paquetes sin alias, utilice el siguiente comando en la interfaz de línea de comandos.
Uso de Qt Online Installer:
<installer executable> search --type package
Para obtener más información sobre los Qt Online Installer ejecutables para diferentes plataformas, consulte Instalación con interacción del usuario.
Usando Qt Maintenance Tool:
<maintenancetool executable> search --type package
Para obtener más información sobre los Qt Maintenance Tool ejecutables para diferentes plataformas, consulte Instalación con interacción del usuario.
Búsqueda avanzada de paquetes de instalación específicos
Busque los paquetes disponibles con el comando search y expresiones regulares: search <regexp>. Puede filtrar los resultados con --filter-packages <regexp>. Por ejemplo, filtrar con la información del nombre para mostrar puede ayudar en la búsqueda.
Por ejemplo, el siguiente comando encuentra todos los paquetes MSVC 2022 para Qt 6.11.0:
search .*6111.*msvc2022
Obtendrá el mismo resultado si filtra el resultado de la búsqueda como se indica a continuación:
search --filter-packages DisplayName=MSVC 2022,Version=6.11.0
Como resultado, obtendrá los siguientes paquetes:
<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>También puede utilizar el filtrado cuando busque todas las versiones de Qt para las que se proporciona algún paquete. Por ejemplo, busque todos los paquetes Qt Charts proporcionados para las versiones de Qt:
search --filter-packages DisplayName=charts
El resultado de la búsqueda es el siguiente:
<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>"/>Instalación sin interacción del usuario
Por defecto, Qt Online Installer o Qt Maintenance Tool pueden solicitar información adicional durante la instalación, lo que requiere la atención del usuario. El uso desatendido a través de la interfaz de línea de comandos es posible proporcionando de antemano toda la información solicitada con las opciones adecuadas.
Nueva instalación con Qt Online Installer
Puede realizar nuevas instalaciones desde la interfaz de línea de comandos sin interacción del usuario de la siguiente manera:
- Defina el Qt Online Installer ejecutable.
- Defina el directorio de instalación con
--root. - Utilice el comando
install <list of packages>con opciones para uso desatendido. Consulte la lista completa de opciones en Opciones para uso desatendido.
Los siguientes ejemplos muestran cómo instalar los binarios de Qt 6.11.0 con Qt Online Installer para Windows, macOS y Linux. Los comandos desatendidos aceptan automáticamente las licencias (--accept-licenses), responden a todas las consultas de mensajes con su respuesta predeterminada (--default-answer), y omiten pedir permiso para seguir ejecutando (--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_64Opciones para el uso desatendido enumera todas las opciones disponibles para el uso desatendido.
Actualización de la instalación con Qt Maintenance Tool
Puede actualizar la instalación existente desde la interfaz de línea de comandos sin interacción del usuario de la siguiente manera:
- Defina el Qt Maintenance Tool ejecutable.
- Utilice
install <list of packages>con opciones para uso desatendido. Consulte la lista completa de opciones en Opciones para uso desatendido.
Los siguientes ejemplos muestran cómo añadir binarios Qt 6.11.0 con Qt Maintenance Tool a una instalación existente en Windows, macOS y Linux. Los comandos desatendidos aceptan automáticamente las licencias (--accept-licenses), responden a todas las consultas de mensajes con su respuesta por defecto (--default-answer), y omiten pedir permiso para seguir ejecutando (--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_64Opciones de uso desatendido
La siguiente tabla enumera todas las opciones para el uso desatendido de la línea de comandos:
| Opción para uso desatendido | Descripción |
|---|---|
--accept-licenses | Acepta automáticamente todos los acuerdos de licencia. |
--accept-obligations | En las instalaciones opensource, acepta las obligaciones de uso de Qt Open Source sin intervención del usuario. |
--default-answer | Responde a todas las consultas de mensajes con su respuesta por defecto. |
--auto-answer <identifier=value> | En caso de que desee respuestas diferentes a determinadas consultas, puede utilizar esta opción. Por ejemplo, --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes. Consulte todos los identificadores de mensajes en Identificadores de mensajes para --auto-answer. |
--accept-messages | Acepta todas las consultas de mensajes. |
--reject-messages | Rechaza todas las consultas de mensajes. |
--confirm-command | Por defecto, Qt Online Installer y Qt Maintenance Tool imprimen un resumen de los componentes que se verán afectados por la opción. Después piden permiso para seguir actuando, para evitar cambios accidentales. Esta opción omite pedir permiso para continuar. |
--email <your_email> | Proporciona el correo electrónico cuando se inicia sesión desde la línea de comandos. Para más información, consulte Proporcionar información de inicio de sesión. |
--pw <your_pw> | Proporciona la contraseña al iniciar sesión desde la línea de comandos. Para obtener más información, consulte Proporcionar información de inicio de sesión. |
--file-query <identifier=value> | En ocasiones, Qt Online Installer solicita la ubicación de un archivo o una carpeta. Puede proporcionar la ubicación con --file-query <identifier=value>. Por ejemplo, --file-query PathForSDP7=<path_to_sdp>.Los identificadores se imprimen en la línea de comandos antes de la pregunta real y el tipo de mensaje. Puede recoger los identificadores a partir de ahí. |
Identificadores de mensaje para --auto-answer
Utilice la opción --auto-answer para proporcionar respuestas a determinadas consultas. La siguiente tabla enumera los identificadores conocidos y los valores utilizados para --auto-answer:
| IDENTIFICADOR | Valores | Por defecto |
|---|---|---|
| OperationDoesNotExistError | Abortar, Ignorar | Ignorar |
| OverwriteTargetDirectory | Sí, No | No |
| stopProcessesForUpdates | Reintentar, Ignorar, Cancelar | Cancelar |
| installationErrorWithCancel | Reintentar, Ignorar, Cancelar | Cancelar |
| installationErrorWithIgnore | Reintentar, Ignorar | Ignorar |
| Asociar tipos de archivo comunes | Sí, No | Sí |
| telemetría-pregunta | Sí, No | Sí |
Proporcionar información de inicio de sesión
Qt Online Installer y Qt Maintenance Tool tienen un inicio de sesión forzado. El inicio de sesión forzado utiliza la información del archivo qtaccount.ini si está disponible en la caché. Encontrará qtaccount. ini de la siguiente manera:
| Host | Ubicación 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 |
Opcionalmente, puede iniciar sesión desde la línea de comandos utilizando los modificadores para correo electrónico y contraseña: --email <your_email> y --pw <your_pw>.
También puede guardar el token jwt en la variable de entorno QT_INSTALLER_JWT_TOKEN. El token se encuentra en el archivo qtaccount.ini.
Instalación con interacción del usuario
Puede utilizar la interfaz de línea de comandos con interacción del usuario del siguiente modo:
- Defina el ejecutable:
- Qt Online Installer si necesita realizar una nueva instalación.
- Qt Maintenance Tool si necesita actualizar una instalación existente.
- Cuando realice una nueva instalación, defina el directorio de instalación con
--root - Utilice
install <list of packages>para instalar los paquetes listados.
Los siguientes ejemplos muestran cómo crear una nueva instalación de los binarios Qt 6.11.0 con Qt Online Installer para Windows, macOS y 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
Los siguientes ejemplos muestran cómo actualizar una instalación existente instalando los binarios Qt 6.11.0 con 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_64Desinstalación de paquetes
La interfaz de línea de comandos proporciona dos comandos para desinstalar paquetes:
- El comando
remove <list of packages>desinstala los paquetes de la lista. - El comando
purgedesinstala todos los paquetes instalados.
Debe utilizar ambos comandos con Qt Maintenance Tool.
Por defecto, Qt Maintenance Tool imprime un resumen de los componentes que se verán afectados por el comando. A continuación, la herramienta pide permiso para seguir actuando, para evitar cambios accidentales. Utilice --confirm-command para omitir la petición de permiso para continuar.
El siguiente ejemplo desinstala los binarios Qt 6.11.0 sin interacción del usuario:
# 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
Los siguientes ejemplos desinstalan todos los paquetes y piden permiso para continuar realizando la acción:
# Windows MaintenanceTool.exe purge # macOS MaintenanceTool.dmg purge # Linux MaintenanceTool.run purge
Listado de paquetes instalados
El comando list lista todos los paquetes instalados. Utilice el comando con Qt Maintenance Tool como se indica a continuación:
# Windows MaintenanceTool.exe list # macOS MaintenanceTool.dmg list # Linux MaintenanceTool.run list
Comprobación de actualizaciones
El comando check-updates comprueba las actualizaciones disponibles para los paquetes instalados. Utilice el comando con Qt Maintenance Tool como se indica a continuación:
# Windows MaintenanceTool.exe check-updates # macOS MaintenanceTool.dmg check-updates # Linux MaintenanceTool.run check-updates
Actualizar paquetes
El comando update actualiza los paquetes instalados. Utilice el comando con Qt Maintenance Tool como se indica a continuación:
# windows MaintenanceTool.exe update # macOS MaintenanceTool.dmg update # linux MaintenanceTool.run update
Comandos populares
Utilice el comando <installer_executable> --help para estudiar los comandos y opciones disponibles. Los comandos populares son los siguientes:
| Comando | Uso |
|---|---|
in, install <pkg ...> | Instala los paquetes dados como argumento. Si no da ningún paquete, instala el conjunto de paquetes por defecto. |
rm, remove <pkg ...> | Desinstala los paquetes seleccionados y sus componentes hijos. |
ch, check-updates | Muestra información sobre las actualizaciones disponibles en Qt Maintenance Tool. |
up, update <pkg ...> | Actualiza los paquetes dados como argumento. Si no se indica ningún paquete, instala todas las actualizaciones disponibles. |
se, search <regexp> | Busca los paquetes disponibles. Si no da ningún patrón de búsqueda, muestra todos los paquetes disponibles. Puede utilizar la opción --filter-packages para especificar filtros adicionales para la operación de búsqueda. Consulte Resumen de opciones en Qt Installer Framework Manual. |
Qt Installer Framework Elmanual proporciona más información sobre los comandos y opciones.
Seleccionar Mirror para Opensource
Qt Online Installer tiene una opción para seleccionar un espejo para metadatos y descargas opensource. Establezca la réplica desde la línea de comandos con la opción --mirror opción.
Por ejemplo, utilice --mirror como se indica a continuación:
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
Como muestra el ejemplo, no utilice la ruta completa sino la ruta antes de '/online' (sin barra diagonal al final).
Encontrará las réplicas disponibles en https://download.qt.io/online/qtsdkrepository/windows_x86/root/qt/Updates.xml.mirrorlist.
Resumen del uso de la interfaz de línea de comandos
Qt Installer Framework El manual proporciona información más detallada sobre la interfaz de línea de comandos:
- Uso desde la línea de comandos describe diferentes casos de uso de la interfaz de línea de comandos.
- Resumen de opciones enumera todas las opciones disponibles.
- Resumen de comandos enumera todos los comandos 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.
