添加 Qt 版本

您可以在开发电脑上安装多个版本的 Qt，并使用它们来构建您的项目。例如，设备制造商会提供专用的 Qt 版本，用于开发针对其设备的应用程序。

要查看已安装的 Qt XML 版本，请选择“Preferences ” > “Kits ” > “Qt Versions ”。

要查看每个 Qt 版本的详细信息，请在列表中选中该版本，然后在“Qt version for ”部分中选择“Details ”。

要删除无效的 Qt 版本，请选择“Clean Up ”。

注册已安装的 Qt 版本

您可以链接到一个已 Qt Online Installer 已安装的 Qt 进行链接，以自动检测已安装的 Qt 版本。 但是，您无法链接到由系统通过其他软件包管理器（例如您的 Linux 发行版、macOS 上的 brew 或 Windows 上的 Chocolatey）安装的 Qt，也无法链接到自建的 Qt。在这些情况下，请按照“设置新的 Qt 版本”中的说明，在“Qt Versions ”选项卡中选择“Add ”以手动添加 Qt 版本。

要链接到 Qt 安装：

1. 选择“Preferences ” > “Kits ” > “Qt Versions ” > “Link with Qt ”。

   

2. 在“Qt installation path ”字段中，输入您安装 Qt 的目录路径。
3. 选择“Link with Qt ”以自动注册 Qt 安装目录中的 Qt 版本和套件。
4. 选择“Restart Now ”以重启Qt Creator 。

要刷新自动检测到的 Qt 版本列表，请选择“Re-detect ”。

要从列表中删除自动检测到的 Qt XML 版本，请选择“Remove Link ”。

如果“Qt Versions ”选项卡的“Automatically Managed ”下未显示 Qt 版本，请手动进行设置。

您可以在“Preferences ”>“Kits ”中为每个套件指定用于构建和运行项目的 Qt 版本。

设置新的 Qt 版本

要注册一个 Qt 版本，请设置指向包含该 Qt 版本的 qmake 或qtpaths 可执行文件的目录路径。

要添加 Qt 版本：

1. 选择“Preferences ” > “Kits ” > “Qt Versions ” > “Add ”。

   要在远程 Linux 设备或 Docker 中添加 Qt 版本，请按住Shift 键，然后选择“Add ”。

2. 选择要添加的 Qt 版本对应的 qmake 或qtpaths 可执行文件。
3. 选择该 Qt 版本以查看和编辑它。
4. 在“Name ”字段中，编辑Qt Creator 为该 Qt 版本建议的名称。
5. 在“qmake path ”字段中，您可以更改 qmake 或qtpaths 的位置。
6. 如果该 Qt 版本适用于 QNX，请在“QNX SDK ”字段中输入 QNX SDK 的路径。

要删除手动添加的 Qt XML 版本，请在“Manual ”列表中选中该版本，然后选择“Remove ”。

注册文档

默认情况下，Qt Creator 仅会为每个已安装的 Qt 模块注册最新可用的文档版本。

要注册所有已安装 Qt 版本的文档集，请从“Register documentation ”列表中选择“All ”。若要完全不注册任何 Qt 文档，请选择“None ”。默认行为是“Highest Version Only ”。

排查 Qt 安装问题

如果Qt Creator 检测到某个 Qt 版本的安装存在问题，它会在列表中该 Qt 版本名称旁边显示警告和错误信息。选择该 Qt 版本可查看有关该问题的更多信息以及修复建议。

要验证特定 Qt 版本的安装情况，Qt Creator 会调用qmake -query 并检查输出中引用的目录是否存在。如果您通过Qt Online Installer 安装了 Qt，请运行Qt Maintenance Tool 以检查更新或重新安装该 Qt 版本。

自建的 Qt 版本

若要使用自编译的 Qt 版本构建项目，请按照“设置新的 Qt 版本”中的说明将其添加。

您的 Qt 必须满足以下最低要求：

• qmake 是一个能够识别-query 命令行参数的可执行文件。
• 必须存在bin 和include 目录。Qt Creator 会通过运行qmake -query 来获取这些目录。

为该 Qt 版本添加一个套件，并为其配置 CMake。

Qt Creator 如果出现以下情况，将发出警告：

• libQtCore.so 缺失时，Qt Creator 将无法检测到 ABI。
• toolchain.cmake 缺失。例如，您在 x86 平台上使用-static 选项构建了 Qt XML。

请尝试以下操作：

• 在构建目录中运行make install ，将 Qt 安装到配置的位置。
• 在Preferences >Kits >Kits >CMake Configuration 中，将CMAKE_PREFIX_PATH 变量的值设置为您安装Qt的位置。