添加 Qt 版本

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

要查看已安装的 Qt 版本，请选择首选项>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 Versions 标签中选择Add ，手动添加Qt 版本。

要链接到 Qt 安装：

1. 选择首选项>Kits >Qt Versions >Link with Qt 。

   

2. 在Qt installation path 字段中，输入安装 Qt 的目录路径。
3. 选择Link with Qt 可在 Qt 安装目录中自动注册 Qt 版本和工具包。
4. 选择Restart Now 可重新启动Qt Creator 。

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

如果Qt Versions 选项卡中没有显示Auto-detected 下的 Qt 版本，请手动设置。

你可以在偏好设置>Kits 中为每个套件指定用于构建和运行项目的 Qt 版本。

设置新的 Qt 版本

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

要添加 Qt 版本，请

1. 选择首选项>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 版本，请在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 缺失，则 无法检测 ABI。Qt Creator
• toolchain.cmake 缺失时会发出警告。例如，您使用 选项为 x86 平台构建 Qt。-static

请尝试以下方法：

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