Descargar e instalar Qt mediante la interfaz de línea de comandos
Utiliza 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 se puede utilizar la interfaz de línea de comandos:
- Descarga de Qt Online Installer mediante la interfaz de línea de comandos
- Nombres de los componentes para la instalación
- Instalación sin intervención del usuario
- Instalación con interacción del usuario
- Desinstalación de paquetes
- Listado de paquetes instalados
- Comprobación de actualizaciones
- Actualización de paquetes
- Comandos habituales
- Selección de un servidor espejo para Opensource
- Resumen del uso de la interfaz de línea de comandos
Descarga de Qt Online Installer mediante la interfaz de línea de comandos
Puedes utilizar el comando « curl » en la interfaz de línea de comandos para descargar Qt Online Installer. Para ver todos los paquetes de Qt Online Installer disponibles para diferentes plataformas, visita Qt Online Installer en la sección de versiones oficiales.
Para descargar un paquete específico de Qt Online Installer con el mismo nombre que el archivo remoto, utiliza la opción -O (con la letra «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.runNombres de los 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 habituales. Los paquetes alias son un atajo que permite incluir los paquetes reales y facilitar así el proceso de instalación.
Listado de paquetes alias existentes
Para ver la lista de paquetes alias existentes, utiliza el siguiente comando en la interfaz de línea de comandos.
Uso de « Qt Online Installer »:
<installer executable> searchPara obtener más información sobre los Qt Online Installer ejecutables para las diferentes plataformas, consulta «Instalación con interacción del usuario».
Uso de Qt Maintenance Tool:
<maintenancetool executable> searchPara obtener más información sobre los Qt Maintenance Tool ejecutables para las distintas plataformas, consulta «Instalación con interacción del usuario».
Contenido de los paquetes de alias
El contenido de los paquetes de alias se detalla en la tabla siguiente.
Nota: En los ejemplos de paquetes de alias que se enumeran a continuación se utiliza la versión 6.12.0de Qt . Recuerda siempre utilizar los paquetes que coincidan con la versión de Qt con la que estés trabajando.
| Nombre del paquete de alias | Qt Online Installer (contenido del paquete) |
|---|---|
| qt6.12.0-essentials |
|
| qt6.12.0-essentials-dev |
|
| qt6.12.0-full |
|
| qt6.12.0-full-dev |
|
| qt6.12.0-full-dbg |
|
| qt6.12.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.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-sdkOpciones de paquetes con 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
Solo se instalan los binarios de MSVC (msvc2022-arm64), ya que no hay otros paquetes binarios de Qt disponibles para Windows en ARM (WoA).
Windows en x86_64
De forma predeterminada, solo se instalan los binarios de MinGW.
Sin embargo, en Windows en x86_64 también se pueden instalar binarios para las siguientes cadenas de herramientas.
- llvm-mingw
- msvc2022
- msvc2022-arm64 (para compilación cruzada)
Al utilizar, por ejemplo, el paquete alias «qt6.12.0-essentials», se instala el paquete con los binarios predeterminados de MinGW.
Para obtener el contenido del paquete « Qt essentials » con, por ejemplo, los binarios de MSVC 2022, utiliza el paquete alias correspondiente «qt6.12.0-msvc2022-essentials ».
Listado de paquetes sin alias
Para mostrar los paquetes que no son alias, utiliza el siguiente comando en la interfaz de línea de comandos.
Uso de « Qt Online Installer »:
<installer executable> search --type packagePara obtener más información sobre los Qt Online Installer ejecutables para las diferentes plataformas, consulta «Instalación con interacción del usuario».
Uso de Qt Maintenance Tool:
<maintenancetool executable> search --type packagePara obtener más información sobre los Qt Maintenance Tool ejecutables para las distintas plataformas, consulta «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 por el nombre que se muestra puede facilitar la búsqueda.
Por ejemplo, el siguiente comando busca todos los paquetes MSVC 2022 para Qt 6.12.0:
search .*6120.*msvc2022Se obtiene el mismo resultado al filtrar los resultados de la búsqueda de la siguiente manera:
search --filter-packages DisplayName=MSVC 2022,Version=6.12.0Como resultado, se obtienen los siguientes paquetes:
<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>También puedes utilizar el filtrado cuando busques todas las versiones de Qt para las que se ofrece un paquete determinado. Por ejemplo, busca todos los paquetes Qt Charts disponibles para las versiones de Qt:
search --filter-packages DisplayName=chartsEl 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 intervenció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 intervención del usuario. Es posible realizar una instalación desatendida a través de la interfaz de línea de comandos proporcionando de antemano toda la información solicitada con las opciones adecuadas.
Nueva instalación con Qt Online Installer
Puedes realizar nuevas instalaciones desde la interfaz de línea de comandos sin intervención del usuario de la siguiente manera:
- Defina el Qt Online Installer ejecutable.
- Especifique el directorio de instalación con
--root. - Utilice el
install <list of packages>comando con las opciones para la instalación desatendida. Consulte la lista completa de opciones en «Opciones para la instalación desatendida».
Los siguientes ejemplos muestran cómo instalar los binarios de Qt 6.12.0 con « Qt Online Installer » para Windows, macOS y Linux. Los comandos sin intervención aceptan automáticamente las licencias (--accept-licenses), responden a todas las consultas de mensajes con su respuesta predeterminada (--default-answer), y omiten la solicitud de permiso para continuar con la ejecución (--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«Opciones para el uso sin intervención » enumera todas las opciones disponibles para el uso sin intervención.
Actualización de la instalación con Qt Maintenance Tool
Puede actualizar una instalación existente desde la interfaz de línea de comandos sin intervención del usuario de la siguiente manera:
- Defina el Qt Maintenance Tool ejecutable.
- Utiliza
install <list of packages>con las opciones para el uso sin supervisión. Consulte la lista completa de opciones en «Opciones para el uso sin supervisión».
Los siguientes ejemplos muestran cómo añadir los binarios de Qt 6.12.0 con Qt Maintenance Tool a una instalación existente en Windows, macOS y Linux. Los comandos sin intervención aceptan automáticamente las licencias (--accept-licenses), responden a todas las consultas de mensajes con su respuesta predeterminada (--default-answer) y omiten la solicitud de permiso para continuar con la ejecución (--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_64Opciones para el uso sin supervisión
La siguiente tabla enumera todas las opciones para el uso de la línea de comandos sin intervención:
| Opción para el uso sin supervisión | Descripción |
|---|---|
--accept-licenses | Acepta automáticamente todos los acuerdos de licencia. |
--accept-obligations | En las instalaciones de código abierto, 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 predeterminada. |
--auto-answer <identifier=value> | Si deseas respuestas diferentes a determinadas consultas, puedes utilizar esta opción. Por ejemplo, --auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes. Consulta 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 | De forma predeterminada, « Qt Online Installer » y « Qt Maintenance Tool » muestran un resumen de los componentes que se verán afectados por la opción. A continuación, solicitan permiso para continuar, con el fin de evitar cambios accidentales. Esta opción omite la solicitud de permiso para continuar. |
--email <your_email> | Proporciona la dirección de correo electrónico al iniciar sesión desde la línea de comandos. Para obtener más información, consulta 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, consulta «Proporcionar información de inicio de sesión». |
--file-query <identifier=value> | A veces, Qt Online Installer solicita la ubicación de un archivo o una carpeta. Puede indicar la ubicación con --file-query <identifier=value>. Por ejemplo, --file-query PathForSDP7=<path_to_sdp>.Los identificadores aparecen en la línea de comandos antes de la pregunta propiamente dicha y del tipo de mensaje. Puede obtener los identificadores de ahí. |
Identificadores de mensajes para --auto-answer
Utiliza la opción « --auto-answer » para proporcionar respuestas a determinadas consultas. La siguiente tabla enumera los identificadores y valores conocidos que se utilizan para « --auto-answer »:
| ID | Valores | Por defecto |
|---|---|---|
| Error de operación inexistente | Abortar, Ignorar | Ignorar |
| Sobrescribir el directorio de destino | Sí, No | No |
| detenerProcesosParaActualizaciones | Reintentar, Ignorar, Cancelar | Cancelar |
| error de instalación con cancelación | Reintentar, Ignorar, Cancelar | Cancelar |
| errorDeInstalaciónConIgnorar | Reintentar, Ignorar | Ignorar |
| Asociar tipos de archivo comunes | Sí, No | Sí |
| pregunta-sobre-telemetría | Sí, No | Sí |
Proporcionar información de inicio de sesión
Qt Online Installer y Qt Maintenance Tool tienen un inicio de sesión obligatorio. El inicio de sesión obligatorio utiliza la información del archivo qtaccount.ini si está disponible en la caché. Puedes 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, puedes iniciar sesión desde la línea de comandos utilizando los parámetros para el correo electrónico y la contraseña: --email <your_email> y --pw <your_pw>.
Como alternativa, puedes guardar el token JWT en la variable de entorno ` QT_INSTALLER_JWT_TOKEN`. Encontrarás el token 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 de la siguiente manera:
- Defina el ejecutable:
- Qt Online Installer si necesitas realizar una nueva instalación.
- Qt Maintenance Tool si necesitas actualizar una instalación existente.
- Al realizar una nueva instalación, define el directorio de instalación con
--root - Utiliza
install <list of packages>para instalar los paquetes indicados.
Los siguientes ejemplos muestran cómo crear una nueva instalación de los binarios de Qt 6.12.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.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_64Los siguientes ejemplos muestran cómo actualizar una instalación existente instalando los binarios de Qt 6.12.0 con 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_64Desinstalación de paquetes
La interfaz de línea de comandos ofrece dos comandos para desinstalar paquetes:
- El
remove <list of packages>comando desinstala los paquetes indicados. - El
purgecomando desinstala todos los paquetes instalados.
Debes utilizar ambos comandos con Qt Maintenance Tool.
Por defecto, Qt Maintenance Tool muestra un resumen de los componentes que se verán afectados por el comando. A continuación, la herramienta solicita permiso para continuar, con el fin de evitar cambios accidentales. Utilice --confirm-command para omitir la solicitud de permiso para continuar.
El siguiente ejemplo desinstala los binarios de Qt 6.12.0 sin intervención del usuario:
# 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_64Los siguientes ejemplos desinstalan todos los paquetes y solicitan permiso para continuar con la acción:
# Windows
MaintenanceTool.exe purge
# macOS
MaintenanceTool.dmg purge
# Linux
MaintenanceTool.run purgeListado de paquetes instalados
El list muestra todos los paquetes que tienes instalados. Utiliza el comando con ` Qt Maintenance Tool ` de la siguiente manera:
# Windows
MaintenanceTool.exe list
# macOS
MaintenanceTool.dmg list
# Linux
MaintenanceTool.run listComprobación de actualizaciones
El check-updates comando comprueba las actualizaciones disponibles para los paquetes instalados. Utiliza el comando con Qt Maintenance Tool de la siguiente manera:
# Windows
MaintenanceTool.exe check-updates
# macOS
MaintenanceTool.dmg check-updates
# Linux
MaintenanceTool.run check-updatesActualización de paquetes
El update comando actualiza los paquetes instalados. Utiliza el comando con Qt Maintenance Tool de la siguiente manera:
# windows
MaintenanceTool.exe update
# macOS
MaintenanceTool.dmg update
# linux
MaintenanceTool.run updateComandos habituales
Utiliza el comando <installer_executable> --help para consultar los comandos y opciones disponibles. Los comandos más habituales son los siguientes:
| Comando | Uso |
|---|---|
in, install <pkg ...> | Instala los paquetes indicados como argumento. Si no se especifica ningún paquete, instala el conjunto de paquetes predeterminado. |
rm, remove <pkg ...> | Desinstala los paquetes seleccionados y sus componentes secundarios. |
ch, check-updates | Muestra información sobre las actualizaciones disponibles en Qt Maintenance Tool. |
up, update <pkg ...> | Actualiza los paquetes indicados como argumento. Si no se indica ningún paquete, instala todas las actualizaciones disponibles. |
se, search <regexp> | Busca paquetes disponibles. Si no se especifica 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 el «Resumen de opciones» en el manual de Qt Installer Framework. |
Qt Installer Framework El manual ofrece más información sobre los comandos y las opciones.
Selección de un servidor espejo para Opensource
Qt Online Installer dispone de una opción para seleccionar un servidor espejo para los metadatos y las descargas de código abierto. Configura el servidor espejo desde la línea de comandos con la --mirror opción.
Por ejemplo, utilice --mirror de la siguiente manera:
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.comComo muestra el ejemplo, no utilices la ruta completa, sino la ruta anterior a «/online» (sin barra al final).
Puede consultar los servidores espejo 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 ofrece información más detallada sobre la interfaz de línea de comandos:
- La sección«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.
- El «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.