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

Qt で Enterprise Debian パッケージを使用するには、Advanced Packaging Tool (APT) に Enterprise リポジトリを追加してください。詳細については、「Debian リポジトリ設定形式」を参照してください。

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

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

注：詳細やサポートについては 、弊社までお問い合わせください。無料トライアルに関する詳細については、「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=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

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

Debian ソースパッケージ

APT 用に Debian ソースパッケージを追加するには、対応するdebエントリに対してdeb-srcエントリを追加する必要があります:

$ 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

ソースパッケージ（例:wayland用）を現在のディレクトリにダウンロードするには、apt source コマンドを使用します:

$ sudo apt source qt-6.12.0-wayland-src

公開GPG鍵のインストール

Enterprise Qt Debian リポジトリ用の公開 GPG (GNU Privacy Guard) 鍵を次のようにインストールします:

$ 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

認証の設定

リストにあるリポジトリにアクセスするには、Enterprise Qt アカウントまたは評価用 Qt アカウントが必要です。

注: パスワードに特殊文字が含まれている場合は 、'\'または'%40' を使用してそれらをエスケープする必要がある場合があります。

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 chmod 600 /etc/apt/auth.conf

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

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

$ sudo apt-get update

出力に、追加したリポジトリに起因するエラーが表示されないことを確認してください。

Debian エイリアスパッケージ

エイリアスパッケージを使用すると、コンテンツをより簡単にインストールできます。エイリアスパッケージとは、実際のDebianパッケージを指し示すメタパッケージにすぎません。

Debian エイリアスパッケージの内容は、以下の表にまとめられています。

注: 以下に挙げるエイリアスパッケージの例では、Qt 6.12.0 リリースが使用されています。必ず、現在作業中の Qt リリースに一致するパッケージを使用するようにしてください。詳細については、「Qt リリースのリポジトリ情報」を参照してください。

エイリアスパッケージ名	パッケージの内容
qt6.12.0-essentials	必須モジュールライブラリ必須モジュールのランタイムツール
qt6.12.0-essentials-dev	必須モジュールライブラリ必須モジュールのヘッダー必須モジュールのプライベートヘッダー必須モジュールのランタイムツール必須モジュールの開発ツール
qt6.12.0-full	必須モジュールのライブラリ必須モジュールランタイムツールアドオンモジュールのライブラリアドオンモジュールのランタイムツール
qt6.12.0-full-dev	すべてのモジュールライブラリすべてのモジュールヘッダーすべてのモジュールのプライベートヘッダーすべてのモジュールランタイムツールすべてのモジュール開発ツール
qt6.12.0-full-dbg	すべてのモジュールのデバッグライブラリ必須モジュールライブラリアドオンモジュールライブラリ

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

$ sudo apt install qt6.12.0-full-dev

完全な設定例

以下のコードスニペットは、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.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

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

トラブルシューティング

認証に関する問題

サーバーから以下のHTTPエラーコードが返される場合があります:

401 認証なし

認証情報が間違っています。ユーザーのメールアドレスとパスワードは、正しい形式で指定する必要があります。

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

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

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

403 アクセス禁止

認証情報が不足しています。

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 アカウント、または Qt for Device Creation ライセンス付きの商用 Qt アカウントが必要です。

注：これらの パッケージは他のディストリビューションでも動作する可能性がありますが、その動作は保証されません。

Qt Creator

アーキテクチャ	ディストリビューション	インストールディレクトリ	APT 用のパッケージリソースリストのエントリ
amd64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-creator/	deb [arch=amd64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qtcreator-amd64 tqtc-jammy main
arm64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-creator/	deb [arch=arm64 signed-by=<パス>] https://debian-packages.qt.io/debian/enterprise/qtcreator-arm64 tqtc-jammy main

Qt 6.12.0

アーキテクチャ	ディストリビューション	インストールディレクトリ	APT 用のパッケージリソースリストのエントリ
amd64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-6.12.0/x86_64-linux-gnu/	deb [arch=amd64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-amd64 tqtc-jammy main
arm64	jammy-jellyfish (Ubuntu 22.04)	/opt/qt-6.12.0/aarch64-linux-gnu/	deb [arch=arm64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main
arm64	bookworm (Debian 12, GLES)	/opt/qt-6.12.0/aarch64-linux-gnu/	deb [arch=arm64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64-gles tqtc-bookworm main

具体的な問題 Wayland と Qt

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