静态编译 Qt 6.5.5

静态编译 Qt 可以让应用程序不依赖于外部 Qt 库，从而简化部署过程。以下是在 Windows 上静态编译 Qt 6.5.5 的步骤：

准备工作

1. 安装必要的工具：

   • Visual Studio（推荐 2019 或 2022 版本）

   • Python 3.6+

   • Perl

   • CMake 3.21+

   • Ninja 构建系统

2. 下载 Qt 6.5.5 源代码：

   • 从 Qt 官方网站下载源码包：https://download.qt.io/official_releases/qt/6.5/6.5.5/single/qt-everywhere-src-6.5.5.zip

静态编译步骤

1. 创建构建目录

mkdir qt-6.5.5-static
cd qt-6.5.5-static
mkdir build
mkdir install

2. 解压源码

将下载的源码包解压到一个目录，例如 C:\qt-everywhere-src-6.5.5

3. 配置编译选项

打开 Visual Studio 开发者命令提示符，然后执行以下命令：

cd C:\qt-6.5.5-static\build

cmake -G Ninja ^
    -DCMAKE_INSTALL_PREFIX=C:/qt-6.5.5-static/install ^
    -DCMAKE_BUILD_TYPE=Release ^
    -DBUILD_SHARED_LIBS=OFF ^
    -DQT_BUILD_EXAMPLES=OFF ^
    -DQT_BUILD_TESTS=OFF ^
    -DFEATURE_static=ON ^
    -DFEATURE_static_runtime=ON ^
    -DCMAKE_PREFIX_PATH=C:/qt-6.5.5-static/install ^
    C:/qt-everywhere-src-6.5.5

4. 编译和安装

cmake --build . --parallel
cmake --install .

常见问题与解决方案

1. 内存不足：

   • 减少并行编译数量：cmake --build . --parallel 2

2. 缺少依赖：

   • 确保安装了所有必要的依赖项，如 OpenGL 开发库

   • 对于 Windows，可能需要安装 DirectX SDK

3. 编译特定模块： 如果你只需要特定的 Qt 模块，可以使用 -DQT_BUILD_MODULES 选项：

-DQT_BUILD_MODULES="Core;Gui;Widgets"

在项目中使用静态编译的 Qt

在你的 CMake 项目中使用静态编译的 Qt：

cmake -G Ninja ^
    -DCMAKE_PREFIX_PATH=C:/qt-6.5.5-static/install ^
    -DCMAKE_BUILD_TYPE=Release ^
    your_project_source_dir

在 qmake 项目中，修改 .pro 文件：

CONFIG += static