Qt for X11 要求

平颱插件依賴

在 Linux, xcb 使用 QPA (Qt 平颱抽象) 平颱插件。它提供所需基本功能通過 Qt GUI and Qt Widgets 以運行針對 X11。下錶描述其庫的依賴。要從其源代碼構建 Qt,還需要為係統安裝這些庫的開發包。

It's possible to configure Qt with -qt-xcb, which compiles in a set of xcb helper libraries instead of trying to link against the system versions. This can help make Qt less dependent on some of the xcb helper libraries that might not be available on all distributions. The table specifies which dependencies are provided by -qt-xcb.

名稱 注意事項 配置選項 最低工作版本
XRender libXrender X 渲染擴展;用於抗鋸齒和 Alpha 光標支持 -xrender 或自動檢測 0.9.0
xcb-render libxcb-render 用於渲染擴展的 X C 綁定 auto-detected or provided by -qt-xcb 1.9
xcb-render-util libxcb-render-util 用渲染擴展的 XCB 實用程序庫 auto-detected or provided by -qt-xcb 0.3.8
xcb-shape libxcb-shape 同步形狀擴展的 X C 綁定 auto-detected or provided by -qt-xcb 1.9
xcb-randr libxcb-randr 用於重置尺寸和鏇轉擴展的 X C 綁定 auto-detected or provided by -qt-xcb 1.9
xcb-xfixes libxcb-xfixes 用於修復擴展的 X C 綁定 auto-detected or provided by -qt-xcb 1.9
xcb-sync libxcb-sync 用於同步擴展的 X C 綁定 auto-detected or provided by -qt-xcb 1.9
xcb-shm libxcb-shm 用於共享內存擴展的 X C 綁定 auto-detected or provided by -qt-xcb 1.9
xcb-icccm libxcb-icccm 用於 ICCCM 協議的 X C 綁定 auto-detected or provided by -qt-xcb 0.3.9
xcb-keysyms libxcb-keysyms 用於鍵碼轉換的 XCB 實用程序庫 auto-detected or provided by -qt-xcb 0.3.9
xcb-image libxcb-image 用於 XImage 和 XShmImage 的 XCB 實用程序庫,用於 QBackingStore 和光標支持 auto-detected or provided by -qt-xcb 0.3.9
xkbcommon libxkbcommon 鍵映射處理 -xkbcommon 或自動檢測 0.5.0
Fontconfig libfontconfig 字體定製和配置 -fontconfig 或自動檢測 2.6
FreeType libfreetype 字體引擎 2.3.0
Xi libXi X11 Input Extensions -xinput 或自動檢測 1.3.0
Xext libXext X 擴展 6.4.3
X11 libX11 X11 客戶端側庫 6.2.1
xcb libxcb X C 綁定庫 1.9
X11-xcb libX11-xcb Xlib/XCB 接口庫 1.3.2
SM libSM X 會話管理 -sm 或自動檢測 6.0.4
ICE libICE ICE (客戶端間交換) -sm 或自動檢測 6.3.5
glib libglib-2.0 常見事件循環處理 -glib 或自動檢測 2.8.3
pthread libpthread 多綫程 2.3.5

這些庫開發包包含從其源代碼構建 Qt 時使用的頭文件。例如,在基於 Debian 的 GNU/Linux 係統,推薦安裝以下開發包:

  • libfontconfig1-dev
  • libfreetype6-dev
  • libx11-dev
  • libxext-dev
  • libxfixes-dev
  • libxi-dev
  • libxrender-dev
  • libxcb1-dev
  • libx11-xcb-dev
  • libxcb-glx0-dev
  • libxkbcommon-x11-dev

Additionally, if you do not configure with -qt-xcb, you should also install these development packages:

  • libxcb-keysyms1-dev
  • libxcb-image0-dev
  • libxcb-shm0-dev
  • libxcb-icccm4-dev
  • libxcb-sync0-dev
  • libxcb-xfixes0-dev
  • libxcb-shape0-dev
  • libxcb-randr0-dev
  • libxcb-render-util0-dev

這些包中的某些依賴此列錶中的其它,因此安裝一個可能導緻其它被自動安裝。其它分布可能為係統包提供類似名稱。

OpenGL 依賴

配置試圖自動檢測 OpenGL ES 2.0 或更高版本或常規桌麵 OpenGL。可以禁用 OpenGL 支持通過使用 -no-opengl 選項。

注意: Qt OpenGL 模塊 (包含類開頭采用 QGL ) 棄用代之 Qt GUI 模塊 (包含類開頭采用 QOpenGL ).

多媒體依賴

作為描述在 多媒體 概述,Qt Multimedia 使用 GStreamer 多媒體框架作為 Linux 音頻、視頻迴放後端。GStreamer 的最低要求版本為 0.10.24。還支持 1.x 係列。

要構建 Qt Multimedia,需要 GStreamer 庫、基插件及係統開發文件。要運行使用 Qt Multimedia 的應用程序,可能還需要安裝以下 GStreamer 插件:good、ugly、bad、ffmpeg (0.10) 及 libav (1.x)。這些額外插件包含用於音頻和視頻解碼的各種編解碼器,及使用攝像頭 API 的必要組件。GStreamer 包名稱在 Linux 分發之間會有所不同。試著搜索 gstreamer or libgstreamer 在分發包存儲庫中查找適閤包。

Qt WebEngine 依賴

Qt WebEngine 擁有的其它構建要求列錶於 Qt WebEngine 平颱注意事項 .

QDoc 依賴

從 v5.11 起, QDoc uses Clang to parse C++ code. If you wish to build QDoc manually, refer to 為 QDoc 安裝 Clang 對於特定構建要求。