Qt6.8.0静态编译：从零开始的终极指南

Qt6.8.0静态编译：从零开始的终极指南

Qt静态编译能够让你创建完全独立的exe程序，无需依赖任何动态链接库。这对于发布应用程序来说非常有用，可以避免用户因为缺少dll文件而无法运行程序的情况。本文将从零开始，详细讲解如何在Windows环境下使用MSVC2022编译器进行Qt6.8.0的静态编译。

1. 安装MSVC 2022

首先需要安装Microsoft Visual Studio 2022。你可以从Visual Studio官网下载安装程序。在安装过程中，确保选择"使用C++的桌面开发"工作负载，这将自动安装所需的编译器和其他工具。

2. 安装OpenSSL 3.4.0

Qt的静态编译需要OpenSSL库。你可以从OpenSSL官网下载最新版本的源码。下载完成后，按照以下步骤进行安装：

1. 解压源码包
2. 打开命令提示符，切换到解压后的目录
3. 运行以下命令进行配置和编译：

perl Configure VC-WIN64A --prefix=C:\openssl
nmake
nmake test
nmake install

3. 安装其他依赖库

根据Qt的官方文档，你还需要安装以下库：

• libclang 17或更高版本
• Python 2.6或更高版本
• CMake 3.21.1或更高版本

你可以从各自的官方网站下载并安装这些库。

1. 下载Qt源码

从Qt官方源码仓库下载Qt6.8.0的源码。你可以使用Git命令进行克隆：

git clone https://code.qt.io/qt/qt5.git qt6
cd qt6
git checkout v6.8.0

2. 配置编译参数

在开始编译之前，你需要配置一些参数。打开命令提示符，运行以下命令：

set QT_HOST_PATH=C:\Qt\6.8.0\msvc2022_64
set PATH=C:\Qt\Tools\CMake_64\bin;C:\Qt\Tools\Python39;%PATH%
set CL=/MP

然后运行configure命令：

configure.bat -static -release -prefix C:\Qt\Static -platform win32-msvc -nomake examples -nomake tests -skip qtwebengine -openssl-linked -I C:\openssl\include -L C:\openssl\lib

3. 开始编译

配置完成后，运行以下命令开始编译：

jom.exe -j 8

这可能需要一些时间，请耐心等待。

1. MSYS2环境下的库依赖问题

在MSYS2环境下进行静态编译时，可能会遇到库依赖问题。解决方法是在.pro文件中添加以下内容：

contains(QT, widgets){
MSYSTEM_PREFIX=$$(MSYSTEM_PREFIX)
greaterThan(MSYSTEM_PREFIX,' '){
contains(CONFIG, static) {
    message ("Perform Qt6 Static library with MSYS2 patch.")
    CONFIG += no_lflags_merge
}
}
}

2. CMake配置文件修补

如果使用CMake进行编译，可能需要对以下文件进行修改：

• C:\msys64\mingw64\qt6-static\lib\cmake\Qt6Gui\Qt6QWindowsIntegrationPluginTargets-release.cmake
• C:\msys64\mingw64\qt6-static\lib\cmake\Qt6Gui\Qt6QWindowsDirect2DIntegrationPluginTargets-release.cmake
• C:\msys64\ucrt64\qt6-static\lib\cmake\Qt6Gui\Qt6QWindowsIntegrationPluginTargets-release.cmake
• C:\msys64\ucrt64\qt6-static\lib\cmake\Qt6Gui\Qt6QWindowsDirect2DIntegrationPluginTargets-release.cmake

需要删除libuiautomationcore.a的绝对路径，只保留文件名。

通过以上步骤，你应该能够成功完成Qt6.8.0的静态编译。虽然过程可能有些复杂，但一旦编译成功，你就可以创建完全独立的exe程序了。如果在编译过程中遇到问题，可以参考Qt官方文档或在Qt论坛寻求帮助。