aqtinstall

另一个QT安装程序（AQT）

• 发布：
• 文档：
• 测试状态：和覆盖范围：
• 代码质量：
• 项目成熟度

这是官方图形QT安装程序的实用程序替代方案，用于在CI环境中使用交互式UI，或者仅在命令行上使用。

当版本在QT下载镜像网站上时，它可以自动下载预定目标的预先构建的QT二进制文件，文档和来源。

笔记

因为它是一个安装程序实用程序，所以它可以从QT发行站点及其镜像下载。该网站由QT公司运营，该公司可能会删除您可能想使用的版本，该版本成为支持的终结。请不要怪我们。

警告

这不是QT公司和QT项目的特许经营权。请不要询问他们有关aqtinstall的信息。

许可证和版权

该程序根据MIT许可分配。

QT SDK及其相关文件属于其许可证。使用AQTINSTALL时，您被认为是同意QT许可证的。 AQTINSTALL将安装QT SDK作为（L）GPL免费软件。

有关详细信息，请参见QT6中使用的QT许可和许可

要求

• 最低python版本：

  3.9

• 推荐的Python版本：

  3.12（经常测试）

• 依赖性：

  请求smantic_version补丁PY7ZR TextTable BS4 Defusedxml

• 操作系统：

  Linux，MacOS，MS Windows

文档

有许多示例的精确文档。建议您阅读入门部分。

• 入门：https：//aqtinstall.readthedocs.io/en/latest/getting_started.html
• 稳定：https：//aqtinstall.readthedocs.io/en/stable
• 最新：https：//aqtinstall.readthedocs.io/en/latest

安装

与往常一样，可以使用pip安装：

 pip install -U pip
pip install aqtinstall

建议您在安装aqtinstall之前更新PIP。

笔记

Aqtinstall取决于几个软件包，这些软件包是从Internet下载文件并提取7ZIP档案所需的，其中一些档案是在几个平台中预编译的。较旧的PIP不会预期处理它（请参阅＃230）。

笔记

当您想在msys2/mingw64环境上使用它时，您需要设置环境变量export SETUPTOOLS_USE_DISTUTILS=stdlib ，因为mingw上的setuptools package in mingw误差升级错误VC6.0 is not supported

警告

PYPI中有一个无关的软件包AQT。请不要混淆。

使用正确版本的Python和所有aqt的依赖项设置一些Windows系统可能很难。为了解决此问题， aqtinstall提供了aqt.exe ，一个窗口可执行文件，其中包含python和所有必需的依赖关系。您可以从“释放”部分，“资产”或通过持续链接aqt.exe的持续链接中访问aqt.exe 。

例子

为Windows安装QT SDK 6.2.0时。

检查可以与list-qt命令一起使用的选项，并查询可用的架构：

 aqt list-qt windows desktop --arch 6.2.0

然后，您可能会得到候选人： win64_mingw81 win64_msvc2019_64 win64_msvc2019_arm64 。您还可以查询可用模块：

 aqt list-qt windows desktop --modules 6.2.0 win64_mingw81

当您决定安装Mingw V8.1的QT SDK 6.2.0版本：

 aqt install-qt windows desktop 6.2.0 win64_mingw81 -m all

可选的-m all参数安装了可用于QT 6.2.0的所有模块；如果您不想要这些模块，则可以将其删除。

要使用模块“ qtcharts”和“ qtnetworking”安装QT 6.2.0，您可以使用此命令（请注意，模块名称是小写）：

 aqt install-qt windows desktop 6.2.0 win64_mingw81 -m qtcharts qtnetworking

当您想使用所需桌面工具集安装Android QT时

 aqt install-qt linux android 5.13.2 android_armv7 --autodesktop

当Aqtinstall下载和安装软件包时，它会更新软件包配置，例如bin/qt.conf中的prefix目录，以及bin/qconfig.pri以使其与已安装目录的运行良好。

笔记

设置一些环境变量以适合您的平台是您自己的任务，例如路径，qt_plugin_path，qml_import_path和qml2_import_path。为了不破坏多个版本的安装，Aqtinstall永远不会为您做。

警告

如果您使用aqtinstall安装iOS版本的QT，请注意，Xcode 13+与QT版本之间存在兼容性问题，小于6.2.4。您可以使用aqtinstall为iOS安装旧版本的QT，但是Aqtinstall的开发人员无法保证旧版本将在MacOS的最新版本上使用。 AQTINSTALL在MACOS 12上的iOS测试，其QT 6.2.4及更大。所有较早版本的QT都预计不起作用。

证词

一些项目利用aqtinstall，有几篇文章和讨论

• github操作：install_qt
• Docker图像：Docker Aqtinstall
• 另一个漫画读者：Yacreader在Azure Pipelines上使用

• 撰稿人纳尔逊（Nelson）的博客文章：QT镜子的快速轻量级无头QT安装程序 - aqtinstall
• Lostdomain.org博客：使用QT使用Azure DevOps管道
• Wincak的博客：使用Azure CI进行跨平台Linux和Windows QT应用程序构建
• QT论坛：Travis CI（或任何其他CI）的自动安装
• QT论坛：QT沉默，无人值守安装
• reddit：QT维护工具现在要求您输入公司名称
• QT研究小组演示：另一个QT CLI安装程序

历史

该程序最初在Kaidan项目中显示为QLI-Installer的名称。 aqtinstall项目扩展并改进了它。