En esta página

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

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

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

Para 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

Para 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 aliasQt Online Installer (contenido del paquete)
qt6.12.0-essentials
  • bibliotecas de módulos esenciales
  • encabezados de los módulos esenciales
  • Cabeceras privadas de los módulos esenciales
  • herramientas de tiempo de ejecución de los módulos esenciales
  • herramientas de desarrollo de módulos esenciales
qt6.12.0-essentials-dev
  • bibliotecas del módulo esencial
  • encabezados del módulo «essential»
  • Cabeceras privadas del módulo esencial
  • herramientas de tiempo de ejecución del módulo esencial
  • herramientas de desarrollo de módulos esenciales
qt6.12.0-full
  • bibliotecas del módulo esencial
  • encabezados del módulo esencial
  • Cabeceras privadas del módulo esencial
  • herramientas de tiempo de ejecución esenciales del módulo
  • herramientas de desarrollo de módulos esenciales
  • bibliotecas de módulos complementarios
  • encabezados de módulos complementarios
  • Cabeceras privadas de módulos complementarios
  • herramientas de tiempo de ejecución de los módulos complementarios
  • herramientas de desarrollo de módulos complementarios
  • códigos fuente
qt6.12.0-full-dev
  • bibliotecas de módulos esenciales
  • Cabeceras de módulos esenciales
  • Cabeceras privadas de módulos esenciales
  • herramientas de tiempo de ejecución de los módulos esenciales
  • herramientas de desarrollo de módulos esenciales
  • bibliotecas de módulos complementarios
  • encabezados de módulos complementarios
  • Cabeceras privadas de módulos complementarios
  • herramientas de tiempo de ejecución de los módulos complementarios
  • herramientas de desarrollo de módulos complementarios
  • códigos fuente
qt6.12.0-full-dbg
qt6.12.0-sdk
  • última versión Qt Creator
  • qt6.12.0-full-dev (detalles más arriba)
  • qt6.12.0-full-dbg (detalles más arriba)
  • Ninja
  • Ejemplos de comandos de CMake

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

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

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

Para 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.*msvc2022

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

Como 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=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 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:

  1. Defina el Qt Online Installer ejecutable.
  2. Especifique el directorio de instalación con --root.
  3. 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:

  1. Defina el Qt Maintenance Tool ejecutable.
  2. 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_64

Opciones 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ónDescripción
--accept-licensesAcepta automáticamente todos los acuerdos de licencia.
--accept-obligationsEn las instalaciones de código abierto, acepta las obligaciones de uso de Qt Open Source sin intervención del usuario.
--default-answerResponde 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-messagesAcepta todas las consultas de mensajes.
--reject-messagesRechaza todas las consultas de mensajes.
--confirm-commandDe 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 »:

IDValoresPor defecto
Error de operación inexistenteAbortar, IgnorarIgnorar
Sobrescribir el directorio de destinoSí, NoNo
detenerProcesosParaActualizacionesReintentar, Ignorar, CancelarCancelar
error de instalación con cancelaciónReintentar, Ignorar, CancelarCancelar
errorDeInstalaciónConIgnorarReintentar, IgnorarIgnorar
Asociar tipos de archivo comunesSí, NoSí
pregunta-sobre-telemetríaSí, NoSí

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:

HostUbicación de qtaccount.ini
WindowsC:\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:

  1. Defina el ejecutable:
    • Qt Online Installer si necesitas realizar una nueva instalación.
    • Qt Maintenance Tool si necesitas actualizar una instalación existente.
  2. Al realizar una nueva instalación, define el directorio de instalación con --root
  3. 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_64

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

Desinstalació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 purge comando 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_64

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

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

Comprobació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-updates

Actualizació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 update

Utiliza el comando <installer_executable> --help para consultar los comandos y opciones disponibles. Los comandos más habituales son los siguientes:

ComandoUso
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-updatesMuestra 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.com

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

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