构建优化的 Qt

本页描述了根据您的特定需求配置和构建更小的定制版 Qt 的过程。

第 1 步：获取源代码、安装构建要求和设置环境

关于获取源代码、安装依赖项和设置环境，请参阅特定平台的说明：

• Windows 版 Qt - 从源代码构建
• 适用于 macOS 的 Qt - 从源代码构建
• 适用于 Linux/X11 的 Qt - 从源代码构建
• 配置嵌入式 Linux 设备
• 适用于 Android 的 Qt - 从源代码构建
• 适用于 iOS 的 Qt - 从源代码构建

步骤 2：构建 Qt 库和工具

按照特定平台的说明，使用以下Qt 配置选项，创建适合您需求的构建。

下表详细描述了有助于减少构建大小的配置选项。

此外，您还可以按照Including or excluding features（包含或排除特性）中的说明逐一删除特性。这可能会对可用组件和功能造成限制。并非所有组合都经过测试。Qt会在持续集成 (CI) 中测试特定的配置选项组合。该配置选项组合能够运行简单的 QML 应用程序。

Qt configure 命令还支持 - -（双破折号）命令行参数，允许用户注入额外的 CMake 参数，如 -DCMAKE_CXX_FLAGS="-march=native"。在交叉编译时，这些参数可通过 -DCMAKE_TOOLCHAIN_FILE=path/to/toolchain.cmake 添加，如《工具链文件示例》中所述。下表列出了一些可以考虑与 GCC 配合使用的选项：

下表列出了链接器选项：

步骤 3：构建应用程序

安装 Qt 后，您就可以开始使用它构建应用程序了。

使用 CMake 项目命令优化 QML 代码生成。有关 QML 代码生成的更多信息，请参阅qt_add_qml_module和Best Practices for QML andQt Quick 。

以下 CMake 代码片段中的命令可缩小二进制文件的大小：

set_target_properties(
        ExampleApp
    PROPERTIES
        QT_QMLCACHEGEN_ARGUMENTS "--only-bytecode"
)

如果您计划在集成开发环境中构建应用程序，则需要在其中明确注册 Qt 版本。有关Qt Creator ，请参阅Qt Creator: 添加 Qt 版本。

如果使用命令行构建应用程序，请遵循特定平台指南。