Paquets Debian Qt pour entreprises

Pour utiliser les paquets Debian Enterprise avec Qt, ajoutez vos dépôts d'entreprise à l'Advanced Packaging Tool (APT). Pour plus de détails, consultez le format de configuration des dépôts Debian.

Pour utiliser les dépôts d'entreprise, vous devez :

• Installer une clé GPG publique pour les dépôts d’entreprise
• Configurer l'authentification par compte Qt pour accéder aux dépôts d'entreprise
• Configurer les dépôts

Format de configuration des dépôts Debian

Pour ajouter des dépôts supplémentaires à APT, insérez-les dans un fichier portant l'extension .list situé dans le répertoire /etc/apt/sources.list.d. Pour chaque dépôt, ajoutez une nouvelle entrée dans le fichier. Le format générique est le suivant :

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

Exemple d'entrée pour un dépôt d'entreprise :

$ 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.12.0-arm64 tqtc-jammy main

Consultez la section Informations sur les dépôts pour les versions de Qt pour obtenir des informations détaillées sur la manière de configurer les dépôts en fonction de la version et de l'architecture de Qt.

Paquets source Debian

Pour ajouter les paquets source Debian à APT, vous devez ajouter une entrée deb-src correspondant à l’entrée deb correspondante :

$ 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.12.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.12.0-arm64 tqtc-jammy main

Pour télécharger les paquets source (par exemple, pour Wayland) dans le répertoire courant, utilisez la commande « apt source » :

$ sudo apt source qt-6.12.0-wayland-src

Installation d’une clé GPG publique

Installez une clé GPG (GNU Privacy Guard) publique pour les dépôts Debian Enterprise Qt comme suit :

$ 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

Configuration de l’authentification

Pour accéder aux dépôts répertoriés, vous devez disposer d'un compte Enterprise Qt ou d'un compte d'évaluation Qt.

Configurez les identifiants de votre compte Qt pour votre gestionnaire de paquets APT comme suit :

$ sudo nano /etc/apt/auth.conf

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

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

Mise à jour du cache de paquets local

Mettez à jour le cache de paquets local comme suit :

$ sudo apt-get update

La sortie ne doit comporter aucune erreur liée au dépôt ajouté.

Paquets alias Debian

Vous pouvez installer le contenu plus facilement à l'aide de paquets alias, qui ne sont que des méta-paquets pointant vers les véritables paquets Debian.

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

Exemple de commande d'installation Debian

$ sudo apt install qt6.12.0-full-dev

Exemple de configuration complète

L'extrait de code suivant illustre l'ensemble du processus avec les paquets Debian Enterprise Qt :

 # 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.12.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.12.0-arm64 tqtc-jammy main

 # update local package cache
 $ sudo apt-get update

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

Consultez les informations sur les dépôts pour les versions de Qt afin de sélectionner les dépôts nécessaires à ajouter dans votre fichier /etc/apt/sources.list.d/tqtc.list.

Dépannage

Problèmes d'authentification

Le serveur peut renvoyer les codes d'erreur HTTP suivants :

401 Non autorisé

Identifiants incorrects. L'adresse e-mail et le mot de passe de l'utilisateur doivent être fournis au format correct.

Essayez également d'enregistrer les identifiants directement dans la configuration du référentiel :

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

Si votre mot de passe contient des caractères spéciaux, vous devrez peut-être les échapper pour APT. Utilisez '' ou '%40' pour échapper ces caractères ou essayez de modifier le mot de passe de votre compte Qt.

403 Accès interdit

Identifiants manquants.

429 Trop de requêtes

L'utilisateur a envoyé trop de requêtes ayant échoué (3 requêtes par minute).

500 Erreur interne du serveur

Contactez le support Qt.

Problèmes liés à l'utilisation de la clé GPG du dépôt

Une alternative à l'attribut d'utilisation « signed-by » dans la configuration du dépôt consiste à installer la clé de la manière suivante, bien que cette méthode ne soit pas recommandée car elle est obsolète :

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

Informations sur les dépôts pour les versions de Qt

Vous trouverez ci-dessous les versions de Qt prises en charge par les paquets Debian Enterprise Qt. Sélectionnez les dépôts nécessaires et ajoutez-les à votre fichier /etc/apt/sources.list.d/tqtc.list comme indiqué ci-dessus.

De plus, les tableaux suivants répertorient les répertoires d’installation sur votre système ainsi que les distributions Linux compatibles avec ces paquets.

Qt Creator

Qt 6.12.0