制作 Qt Creator 以查看示例和文档

Posted 2023-02-14

【中文标题】制作 Qt Creator 以查看示例和文档

【英文标题】：Make Qt Creator to see examples and docs

【发布时间】：2017-08-02 07:21:12

【问题描述】：

我在 Ubuntu 16.04.3 上从 www.qt.io 下载的源代码构建 Qt 5.9.1。我在构建 Qt 时使用 -make examples 作为 configure 脚本。

默认前缀/usr/local安装后有/usr/local/Qt-5.9.1/examples/和/usr/local/Qt-5.9.1/doc/。

我还从官方网站安装了 Qt Creator 4.3.1。

在“示例”中 Qt Creator 的“欢迎”页面上，我在组合框中看到自动检测到的“Qt 5.9.1 in PATH (Qt-5.9.1)”条目（在另一个安装中）我什至没有看到这个条目 - 组合框是空的）。并且没有一个例子本身的图标。在搜索框中输入任何有意义的关键字都没有任何作用。

当我打开我的（完全可构建的）项目并在任何 Qt 类名称上点击 F1 时，我希望在右侧拆分窗口中看到有关它的帮助。然后什么也没有发生，只有“没有可用的文档”。显示文本。

已安装Qt的qmake在PATH中，/etc/environment中有QTDIR=/usr/local/Qt-5.9.1。

如何让 Qt Creator 从自动检测到的 Qt 安装中查看文档、示例和演示？

【问题讨论】：

我通常发现使用 Qt Online 安装程序（在 Linux 下到用户主目录）安装所有内容（包括至少一个 Qt 版本）是最简单的。然后，您可以将自定义编译的 Qt 版本或 Linux 发行版的本机 Qt 版本添加到其 Qt Creator 安装中。

【参考方案1】：

如果有人从 Ubuntu 软件包中安装了 qtcreator，则可以通过以下方式安装示例：

sudo apt-get install qtbase5-examples qtbase5-doc-html

这将显示基本的widget 示例。

Additional examples（例如 qt quick）可以通过显式安装来添加：

sudo apt install qtquickcontrols2-5-examples

要真正让它们显示在qtcreator 中，我必须安装：

sudo apt install qt5-doc qt5-doc-html

编辑：

还要确保安装你需要的 qml 模块，例如：

sudo apt install qml-module-qtquick-controls2

【参考方案2】：

在 Qt Creator 中选择 Tools → Options → Help → Documentation 并添加来自 /usr/local/Qt-5.9.1/doc/ 的 *.qch 文件（也可能来自 /usr/local/Qt-5.9.1/examples/ ？）。

【讨论】：

问题出在 qtmacextras 子模块中。 configure -skip qtmacextras 解决了这个问题。那么我不仅需要make，还需要make docs 和make install_docs。