Linux 向け Qt - 要件
プラットフォームプラグインの依存関係
Linux では、xcbQPA(Qt Platform Abstraction)プラットフォームプラグインが使用されます。これは、以下に必要な基本機能を提供します。 Qt GUI および Qt Widgets がX11上で動作するために必要な基本機能を提供します。そのライブラリ依存関係は、次の表に示されています。ソースコードからQtをビルドするには、お使いのシステム向けにこれらのライブラリの開発パッケージもインストールする必要があります。
| 名前 | ライブラリ | 備考 | 設定オプション | 動作に必要な最低バージョン |
|---|---|---|---|---|
| XRender | libXrender | X レンダリング拡張機能。アンチエイリアシングおよびアルファカーソルのサポートに使用されます | -xrender または自動検出 | 0.9.0 |
| xcb-render | libxcb-render | Render 拡張機能用の X C バインディング | 自動検出 | 1.11 |
| xcb-render-util | libxcb-render-util | Render拡張機能向けのXCB用ユーティリティライブラリ | 自動検出 | 0.3.9 |
| xcb-shape | libxcb-shape | Shape拡張機能用のXC Bindings | 自動検出 | 1.11 |
| xcb-randr | libxcb-randr | Resize および Rotate 拡張機能用の X C バインディング | 自動検出 | 1.11 |
| xcb-xfixes | libxcb-xfixes | Fixes拡張機能用のX Cバインディング | 自動検出 | 1.11 |
| xcb-xkb | libxcb-xkb | XKeyboard 拡張機能用 X C バインディング | 自動検出 | 1.11 |
| xcb-sync | libxcb-sync | Sync拡張機能用のX Cバインディング | 自動検出 | 1.11 |
| xcb-shm | libxcb-shm | 共有メモリ拡張機能用の X C バインディング | 自動検出 | 1.11 |
| xcb-icccm | libxcb-icccm | ICCCM プロトコル用 X C バインディング | 自動検出 | 0.3.9 |
| xcb-keysyms | libxcb-keysyms | キーコード変換のための XCB 用ユーティリティライブラリ | 自動検出 | 0.3.9 |
| xcb-image | libxcb-image | XImage および XShmImage 用の XCB ユーティリティライブラリ。QBackingStore およびカーソルサポートに使用されます。 | 自動検出 | 0.3.9 |
| xcb-util | libxcb-util | atom、aux、およびイベント用の XCB ユーティリティライブラリ | 自動検出 | 0.3.9 |
| xcb-cursor0 | libxcb-cursor0 | XCB用ユーティリティライブラリ(cursor用) | 自動検出 | 0.1.1 |
| xkbcommon | libxkbcommon | キーマップ処理 | -xkbcommon または自動検出 | 0.9.0 |
| xkbcommon-x11 | libxkbcommon-x11 | キーマップの処理 | 自動検出 | 0.9.0 |
| Fontconfig | libfontconfig | フォントのカスタマイズと設定 | -fontconfig または自動検出 | 2.6 |
| FreeType | libfreetype | フォントエンジン | 2.3.0 | |
| Xext | libXext | X 拡張機能 | 6.4.3 | |
| X11 | libX11 | X11 クライアントサイドライブラリ | 6.2.1 | |
| xcb | libxcb | X C バインディングライブラリ | 1.11 | |
| X11-xcb | libX11-xcb | Xlib/XCB インターフェースライブラリ | 1.3.2 | |
| SM | libSM | X セッション管理 | -sm または自動検出 | 6.0.4 |
| ICE | libICE | クライアント間交換 | -sm または自動検出 | 6.3.5 |
| glib | libglib-2.0 | 共通のイベントループ処理 | -glib または自動検出 | 2.8.3 |
| pthread | libpthread | マルチスレッド | 2.3.5 |
上記のライブラリ用の開発パッケージには、Qt をソースコードからビルドする際に使用されるヘッダーファイルが含まれています。パッケージ名は Linux ディストリビューションによって異なる場合があり、また、ディストリビューションによっては、パッケージ管理システムのデフォルト設定にすべてのパッケージが含まれていない場合もあります。
例として、Debian ベースの GNU/Linux システムでは、次のコマンドを実行して推奨パッケージをインストールできます。
apt install \
libfontconfig1-dev \
libfreetype-dev \
libgtk-3-dev \
libx11-dev \
libx11-xcb-dev \
libxcb-cursor-dev \
libxcb-glx0-dev \
libxcb-icccm4-dev \
libxcb-image0-dev \
libxcb-keysyms1-dev \
libxcb-randr0-dev \
libxcb-render-util0-dev \
libxcb-shape0-dev \
libxcb-shm0-dev \
libxcb-sync-dev \
libxcb-util-dev \
libxcb-xfixes0-dev \
libxcb-xkb-dev \
libxcb1-dev \
libxext-dev \
libxfixes-dev \
libxi-dev \
libxkbcommon-dev \
libxkbcommon-x11-dev \
libxrender-devこれらのパッケージの中には、このリスト内の他のパッケージに依存しているものもあるため、1つをインストールすると、他のパッケージが自動的にインストールされる場合があります。他のディストリビューションでは、同様の名前のシステムパッケージが提供されている場合があります。
Qt は、すべてのディストリビューションを対象とした包括的なパッケージリストを管理しているわけではありません。 Red Hat™ およびその派生ディストリビューションなどでは、特定のパッケージ(例:RHEL の場合は EPEL)を取得するために追加のリポジトリが必要になる場合があります。具体的なパッケージ名については、お使いのディストリビューションのドキュメントを参照してください。RHEL ユーザーは、詳細情報についてRed Hat サポートにお問い合わせください。
アクセシビリティの依存関係
Qtのアクセシビリティ実装では、Assistive Technology Service Provider Interface(AT-SPI)を使用します。DBUSに加え、開発パッケージlibatspi2.0-dev をインストールする必要があります。
OpenGL の依存関係
configure は、OpenGL ES 2.0 以降、または通常のデスクトップ用 OpenGL を自動的に検出しようとします。-no-opengl オプションを使用することで、OpenGL サポートを無効にすることができます。
注: Qt OpenGL モジュール (QGLで始まるクラスを含む)は 、 Qt GUI モジュール(QOpenGL で始まるクラスを含む)に置き換えられ、非推奨となっています。
QDoc の依存関係
QDoc は、C++ コードの解析に Clang を使用します。QDoc を手動でビルドする場合は、「QDoc 用の Clang のインストール」を参照して、具体的なビルド要件を確認してください。
© 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.