Enterprise-Qt-Debian-Pakete

Um Enterprise-Debian-Pakete mit Qt zu verwenden, fügen Sie Ihre Enterprise-Repositorys zum Advanced Packaging Tool (APT) hinzu. Weitere Informationen finden Sie unter „Debian-Repository-Konfigurationsformat“.

Um die Enterprise-Repositorys zu nutzen, müssen Sie:

• Installieren Sie einen öffentlichen GPG-Schlüssel für die Enterprise-Repositories
• Konfigurieren Sie die Qt-kontobasierte Authentifizierung für den Zugriff auf Enterprise-Repositorys
• Konfigurieren Sie die Repositories

Konfigurationsformat für Debian-Repositorys

Um zusätzliche Repositorien für APT hinzuzufügen, fügen Sie die Repositorien in eine Datei mit der Erweiterung .list im Verzeichnis /etc/apt/sources.list.d ein. Fügen Sie für jedes Repositorium einen neuen Eintrag in die Datei ein. Das allgemeine Format lautet wie folgt:

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

Ein Beispiel für einen Eintrag für ein Unternehmens-Repository:

$ 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

Ausführliche Informationen dazu, wie Sie Repositorys für die jeweiligen Qt-Versionen und Architekturen konfigurieren können, finden Sie unter „Repository-Informationen für Qt-Versionen “.

Debian-Quellpakete

Um die Debian-Quellpakete für APT hinzuzufügen, müssen Sie einen „deb-src“-Eintrag für den entsprechenden „deb“-Eintrag hinzufügen:

$ 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

Um Quellpakete (zum Beispiel für Wayland) in das aktuelle Verzeichnis herunterzuladen, verwenden Sie den Befehl „ apt source “:

$ sudo apt source qt-6.12.0-wayland-src

Installieren eines öffentlichen GPG-Schlüssels

Installieren Sie einen öffentlichen GPG-Schlüssel (GNU Privacy Guard) für die Enterprise-Qt-Debian-Repositorys wie folgt:

$ 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

Konfigurieren der Authentifizierung

Um auf die aufgeführten Repositories zugreifen zu können, benötigen Sie ein Enterprise-Qt-Konto oder ein Qt-Testkonto.

Konfigurieren Sie die Anmeldedaten des Qt-Kontos für Ihren APT-Paketmanager wie folgt:

$ 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

Aktualisieren des lokalen Paket-Caches

Aktualisieren Sie den lokalen Paket-Cache wie folgt:

$ sudo apt-get update

In der Ausgabe sollten keine Fehler im Zusammenhang mit dem hinzugefügten Repository auftreten.

Debian-Alias-Pakete

Mit Alias-Paketen, bei denen es sich lediglich um Metapakete handelt, die auf die eigentlichen Debian-Pakete verweisen, lässt sich der Inhalt einfacher installieren.

Der Inhalt der Debian-Alias-Pakete ist in der folgenden Tabelle aufgeführt.

Beispiel für einen Debian-Installationsbefehl

$ sudo apt install qt6.12.0-full-dev

Beispiel für eine vollständige Konfiguration

Der folgende Codeausschnitt veranschaulicht den gesamten Arbeitsablauf mit Enterprise-Qt-Debian-Paketen:

 # 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

Siehe Repository-Informationen zu Qt-Versionen, um die benötigten Repositories in Ihre Datei /etc/apt/sources.list.d/tqtc.list aufzunehmen.

Fehlerbehebung

Schwierigkeiten bei der Authentifizierung

Der Server gibt möglicherweise folgende HTTP-Fehlercodes zurück:

401 Nicht autorisiert

Falsche Anmeldedaten. E-Mail-Adresse und Passwort des Benutzers müssen im korrekten Format angegeben werden.

Versuchen Sie außerdem, die Anmeldedaten direkt in der Repository-Konfiguration zu speichern:

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

Wenn Ihr Passwort Sonderzeichen enthält, müssen Sie diese möglicherweise für APT escapen. Verwenden Sie „“ oder „%40“, um diese Zeichen zu escapen, oder versuchen Sie, das Passwort Ihres Qt-Kontos zu ändern.

403 Zugriff verweigert

Anmeldedaten fehlen.

429 Zu viele Anfragen

Der Benutzer hat zu viele fehlgeschlagene Anfragen gesendet (3 Anfragen pro Minute).

500 Interner Serverfehler

Wenden Sie sich an den Qt-Support.

Probleme bei der Verwendung des GPG-Schlüssels im Repository

Eine Alternative zum Attribut „ signed-by “ in der Repository-Konfiguration ist die Installation des Schlüssels auf folgende Weise, obwohl dies nicht empfohlen wird, da es sich um eine veraltete Installationsmethode handelt:

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

Repository-Informationen für Qt-Versionen

Nachfolgend finden Sie die Qt-Versionen, die von den Enterprise-Qt-Debian-Paketen unterstützt werden. Wählen Sie die benötigten Repositories aus und fügen Sie sie wie oben beschrieben zu Ihrer Datei ` /etc/apt/sources.list.d/tqtc.list ` hinzu.

Außerdem sind in den folgenden Tabellen die Installationsverzeichnisse auf Ihrem System sowie die mit den Paketen kompatiblen Linux-Distributionen aufgeführt.

Qt Creator

Qt 6.12.0