エンタープライズ Qt Debian パッケージ

Qt でエンタープライズ Debian パッケージを使用するには、エンタープライズリポジトリを Advanced Packaging Tool (APT) に追加してください。詳細については、Debian Repository Configuration Format を参照してください。

エンタープライズリポジトリを使用するには、以下が必要です：

• エンタープライズリポジトリ用の公開 GPG 鍵をインストールする。
• エンタープライズリポジトリへのアクセス用にQt アカウントベース認証を設定する。
• リポジトリの設定

Debian リポジトリ設定フォーマット

APT 用に追加のリポジトリを追加するには、/etc/apt/sources.list.dディレクトリの下の拡張子.listのファイルにリポジトリを挿入します。リポジトリごとに、ファイルに新しいエントリを追加します。一般的な書式は以下の通りです：

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

エンタープライズリポジトリのエントリの例です：

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

    deb [arch=arm64 signed-by=/home/<user>/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.8.0-arm64 tqtc-jammy main

Qt リリースやアーキテクチャごとにリポジトリを設定する方法の詳細については、Qt リリースのリポジトリ情報を参照してください。

パブリック GPG キーのインストール

以下の手順に従って、Enterprise Qt Debian リポジトリ用のパブリック GPG (GNU Privacy Guard) キーをインストールしてください：

$ mkdir -p $HOME/keyrings/tqtc  # pick a suitable location for you!
$ cd $HOME/keyrings/tqtc
$ wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

認証の設定

一覧にあるリポジトリにアクセスするには、エンタープライズ Qt アカウントまたは評価版 Qt アカウントが必要です。

APT パッケージマネージャの Qt アカウント認証情報を以下のように設定してください：

$ sudo nano /etc/apt/auth.conf

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

ローカルパッケージキャッシュの更新

以下のようにローカルパッケージキャッシュを更新します：

$ sudo apt-get update

追加したリポジトリからエラーが出力されないようにしてください。

Debian エイリアスパッケージ

実際の Debian パッケージを指す単なるメタパッケージであるエイリアスパッケージを使えば、より簡単にコンテンツをインストールできます。

Debian エイリアスパッケージの内容は、以下の表の通りです。

Debian インストールコマンドの例

$ sudo apt install qt6.8.0-full-dev

完全な設定例

以下のコードスニペットは、Enterprise Qt Debian パッケージを使用した作業全体の流れを示しています：

# install repository key
$ mkdir -p $HOME/keyrings/tqtc
$ cd $HOME/keyrings/tqtc
$ 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=/home/<user>/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.8.0-arm64 tqtc-jammy main

# update local package cache
$ sudo apt-get update

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

必要なリポジトリを/etc/apt/sources.list.d/tqtc.listファイルに追加するには、Qt リリースのリポジトリ情報を参照してください。

トラブルシューティング

認証の問題

サーバーが以下のHTTPエラーコードで応答することがあります：

401 Unauthorized

認証情報が間違っています。ユーザーのメールアドレスとパスワードは正しい形式で入力してください。

また、認証情報をリポジトリ設定に直接保存してみてください：

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

パスワードに特殊文字が含まれている場合、APT 用にエスケープする必要があるかもしれません。パスワードに特殊な文字が含まれている場合、APT のためにそれらの文字をエスケープする必要があるかもしれません。これらの文字をエスケープするには '' または '%40' を使用するか、Qt アカウントのパスワードを変更してみてください。

403 Forbidden

認証情報がありません。

429 リクエストが多すぎます

ユーザーが送信したリクエストが多すぎます (1 分間に 3 リクエスト)。

500 内部サーバーエラー

Qt サポートに連絡してください。

リポジトリの GPG 鍵の使用に関する問題

リポジトリ設定の 'signed-by' 属性に代わる方法として、以下の方法で鍵をインストールすることができます：

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

Qt リリースのリポジトリ情報

以下に、Enterprise Qt Debian パッケージがサポートしている Qt のリリースを示します。必要なリポジトリを選び、上記の指示に従って/etc/apt/sources.list.d/tqtc.listに追加してください。

また、以下の表は、システム上のインストールディレクトリと、パッケージと互換性のある Linux ディストリビューションの一覧です。

Qt Creator

Qt 6.8.0