En esta página

Paquetes Debian de Qt para empresas

Para usar paquetes Enterprise Debian con Qt, añada sus repositorios enterprise a Advanced Packaging Tool (APT). Para más detalles, consulte Formato de configuración de repositorios Debian.

Para usar los repositorios de empresa, necesita:

Nota: Para más detalles y soporte, contacte con nosotros. Para más información sobre pruebas gratuitas, consulte Pruebas gratuitas de software Qt.

Formato de configuración de repositorios de Debian

Para añadir repositorios adicionales para APT, inserte los repositorios en un archivo con extensión .list en el directorio /etc/apt/sources.list.d. Para cada repositorio, añada una nueva entrada en el fichero. El formato genérico es el siguiente:

deb [arch=<arch> signed-by=<path>] <REPO_URL> <DIST> <COMPONENT(s)>

Un ejemplo de una entrada de repositorio de empresa:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-arm64 tqtc-jammy main

Consulte Información de repositorios para versiones de Qt para obtener información detallada sobre cómo puede configurar repositorios por versión y arquitectura de Qt.

Paquetes fuente Debian

Para añadir los paquetes fuente de Debian para APT, necesita añadir una entrada deb-src para la entrada deb correspondiente:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-arm64 tqtc-jammy main
    deb-src [signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-arm64 tqtc-jammy main

Para descargar paquetes fuente (por ejemplo, para wayland) al directorio actual, utilice la orden apt source:

$ sudo apt source qt-6.11.0-wayland-src

Instalación de una clave GPG pública

Instale una clave GPG (GNU Privacy Guard) pública para los repositorios de Enterprise Qt Debian como se indica a continuación:

$ sudo mkdir -p /etc/apt/keyrings/tqtc  # Create the directory with appropriate permissions
$ cd /etc/apt/keyrings/tqtc
$ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

Configuración de la autenticación

Para acceder a los repositorios listados, necesita una cuenta Qt de empresa o una cuenta Qt de evaluación.

Nota: Si su contraseña contiene caracteres especiales, puede que tenga que escaparlos utilizando '\' o '%40'.

Configure las credenciales de la cuenta Qt para su gestor de paquetes APT como se indica a continuación:

$ sudo nano /etc/apt/auth.conf

      machine https://debian-packages.qt.io
      login <Qt Account login name (email)>
      password <Qt Account password>

Advertencia: Este archivo puede contener información sensible. Para evitar que otros usuarios del sistema lean la contraseña, asegúrese de que el archivo tiene permisos estrictos:

$ sudo chmod 600 /etc/apt/auth.conf

Actualización de la caché local de paquetes

Actualice la caché local de paquetes como se indica a continuación:

$ sudo apt-get update

En la salida no debería producirse ningún error desde el repositorio añadido.

Paquetes Debian Alias

Puede instalar el contenido más fácilmente con paquetes alias, que no son más que meta-paquetes que apuntan a los paquetes Debian reales.

Los contenidos de los paquetes alias de Debian se listan en la siguiente tabla.

Nota: La versión 6.11.0 de Qt se usa en los ejemplos de paquetes alias listados a continuación. Recuerde siempre usar los paquetes que coincidan con la versión de Qt en la que esté trabajando. Para obtener más información, consulte Información del repositorio para las versiones de Qt.

Nombre del paquete aliasContenido del paquete
qt6.11.0-essentials
qt6.11.0-essentials-dev
  • bibliotecas de módulos esenciales
  • cabeceras de módulos esenciales
  • módulo esencial cabeceras privadas
  • herramientas de tiempo de ejecución de módulos esenciales
  • herramientas de desarrollo de módulos esenciales
qt6.11.0-full
qt6.11.0-full-dev
  • todas las bibliotecas de módulos
  • todas las cabeceras de módulos
  • todas las cabeceras privadas del módulo
  • todas las herramientas de ejecución de módulos
  • todas las herramientas de desarrollo de módulos
qt6.11.0-full-dbg

Ejemplo de orden de instalación en Debian

$ sudo apt install qt6.11.0-full-dev

Ejemplo de configuración completa

El siguiente fragmento de código demuestra todo el flujo de trabajo con los paquetes Enterprise Qt Debian:

 # install repository key
 $ sudo mkdir -p /etc/apt/keyrings/tqtc
 $ cd /etc/apt/keyrings/tqtc
 $ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

 # configure Qt Account based authentication to Qt Debian repositories
 $ sudo nano /etc/apt/auth.conf
   machine https://debian-packages.qt.io
   login <your Qt Account email>
   password <your Qt Account password>

 # add repositories
 $ sudo nano /etc/apt/sources.list.d/tqtc.list
     deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt6.11.0-arm64 tqtc-jammy main

 # add source packages
 $ sudo nano /etc/apt/sources.list.d/tqtc.list
     deb-src [signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-arm64 tqtc-jammy main

 # update local package cache
 $ sudo apt-get update

 # search and install packages
 $ apt-cache search qt6.11.0-full-dev
 ....
 ....
 # files are installed under /opt/qt-6.11.0
$ sudo apt install qt6.11.0-full-dev

Consulte Información de repositorios para versiones de Qt para seleccionar los repositorios necesarios en su archivo /etc/apt/sources.list.d/tqtc.list.

Resolución de problemas

Dificultades en la autenticación

El servidor puede responder con los siguientes códigos de error HTTP

401 No autorizado

Credenciales incorrectas. El correo electrónico y la contraseña del usuario deben proporcionarse en el formato correcto.

Además, intente almacenar las credenciales directamente en la configuración del repositorio:

deb [...] https://<Qt Account email>:<Qt Account passwd>@https://debian-packages.qt.io/.....

Si su contraseña contiene caracteres especiales, es posible que tenga que escaparlos para APT. Utilice '' o '%40' para escapar esos caracteres o intente cambiar la contraseña de su cuenta Qt.

403 Prohibido

Faltan credenciales.

429 Demasiadas peticiones

El usuario ha enviado demasiadas peticiones fallidas (3 peticiones por minuto).

500 Error interno del servidor

Contacte con el soporte de Qt.

Dificultades con el uso de la clave GPG del repositorio

Una alternativa al atributo de uso signed-by en la configuración del repositorio es instalar la clave de la siguiente forma, aunque no se recomienda ya que es una forma obsoleta de instalarla:

$ sudo apt-key add qt-company-debian-repo.gpg

Información del repositorio para las versiones de Qt

A continuación puede encontrar las versiones de Qt compatibles con los paquetes Enterprise Qt de Debian. Elija los repositorios necesarios y añádalos a su /etc/apt/sources.list.d/tqtc.list como se indica más arriba.

Además, las siguientes tablas enumeran los directorios de instalación en su sistema y la distribución de Linux compatible con los paquetes.

Nota: Para acceder a los repositorios listados, necesitas una cuenta Qt de evaluación o una cuenta Qt comercial con una licencia Qt for Device Creation.

Nota: Los paquetes pueden funcionar también en otras distribuciones pero no hay garantía de ello.

Qt Creator

ArquitecturaDistribuciónDirectorio de instalaciónEntradas de la lista de recursos de paquetes para APT
amd64jammy-jellyfish (Ubuntu 22.04)/opt/qt-creator/deb [arch=amd64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qtcreator-amd64 tqtc-jammy main
arm64jammy-jellyfish (Ubuntu 22.04)/opt/qt-creator/deb [arch=arm64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qtcreator-arm64 tqtc-jammy main

Qt 6.11.0

ArquitecturaDistribuciónDirectorio de instalaciónEntradas de la lista de recursos de paquetes para APT
amd64jammy-jellyfish (Ubuntu 22.04)/opt/qt-6.11.0/x86_64-linux-gnu/deb [arch=amd64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-amd64 tqtc-jammy main
arm64jammy-jellyfish (Ubuntu 22.04)/opt/qt-6.11.0/aarch64-linux-gnu/deb [arch=arm64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-arm64 tqtc-jammy main
arm64bookworm (Debian 12, GLES)/opt/qt-6.11.0/aarch64-linux-gnu/deb [arch=arm64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.11.0-arm64-gles tqtc-bookworm main

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