このページでは

Linux 向け Qt - 要件

プラットフォームプラグインの依存関係

Linux では、xcbQPA(Qt Platform Abstraction)プラットフォームプラグインが使用されます。これは、以下に必要な基本機能を提供します。 Qt GUI および Qt Widgets がX11上で動作するために必要な基本機能を提供します。そのライブラリ依存関係は、次の表に示されています。ソースコードからQtをビルドするには、お使いのシステム向けにこれらのライブラリの開発パッケージもインストールする必要があります。

名前ライブラリ備考設定オプション動作に必要な最低バージョン
XRenderlibXrenderX レンダリング拡張機能。アンチエイリアシングおよびアルファカーソルのサポートに使用されます-xrender または自動検出0.9.0
xcb-renderlibxcb-renderRender 拡張機能用の X C バインディング自動検出1.11
xcb-render-utillibxcb-render-utilRender拡張機能向けのXCB用ユーティリティライブラリ自動検出0.3.9
xcb-shapelibxcb-shapeShape拡張機能用のXC Bindings自動検出1.11
xcb-randrlibxcb-randrResize および Rotate 拡張機能用の X C バインディング自動検出1.11
xcb-xfixeslibxcb-xfixesFixes拡張機能用のX Cバインディング自動検出1.11
xcb-xkblibxcb-xkbXKeyboard 拡張機能用 X C バインディング自動検出1.11
xcb-synclibxcb-syncSync拡張機能用のX Cバインディング自動検出1.11
xcb-shmlibxcb-shm共有メモリ拡張機能用の X C バインディング自動検出1.11
xcb-icccmlibxcb-icccmICCCM プロトコル用 X C バインディング自動検出0.3.9
xcb-keysymslibxcb-keysymsキーコード変換のための XCB 用ユーティリティライブラリ自動検出0.3.9
xcb-imagelibxcb-imageXImage および XShmImage 用の XCB ユーティリティライブラリ。QBackingStore およびカーソルサポートに使用されます。自動検出0.3.9
xcb-utillibxcb-utilatom、aux、およびイベント用の XCB ユーティリティライブラリ自動検出0.3.9
xcb-cursor0libxcb-cursor0XCB用ユーティリティライブラリ(cursor用)自動検出0.1.1
xkbcommonlibxkbcommonキーマップ処理-xkbcommon または自動検出0.9.0
xkbcommon-x11libxkbcommon-x11キーマップの処理自動検出0.9.0
Fontconfiglibfontconfigフォントのカスタマイズと設定-fontconfig または自動検出2.6
FreeTypelibfreetypeフォントエンジン2.3.0
XextlibXextX 拡張機能6.4.3
X11libX11X11 クライアントサイドライブラリ6.2.1
xcblibxcbX C バインディングライブラリ1.11
X11-xcblibX11-xcbXlib/XCB インターフェースライブラリ1.3.2
SMlibSMX セッション管理-sm または自動検出6.0.4
ICElibICEクライアント間交換-sm または自動検出6.3.5
gliblibglib-2.0共通のイベントループ処理-glib または自動検出2.8.3
pthreadlibpthreadマルチスレッド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.