Windows 下纯手工打造 QT 开发环境

用过 QtCreator 和 VS QT 插件,都觉得不是很理想。所以有了这个想法。

手工打造的 QT 的开发环境,是不需要安装上面两个程序的。

1、下载 vcpkg,编译 QT6

下载地址:https://github.com/microsoft/vcpkg.git

进入到 vcpkg 目录,在命令行上输入:

vcpkg install qt:x86-windows-static

vcpkg install qt:x64-windows-static

这样,QT6 的头文件、库文件(MT 类型的静态库 )都有了,理论上就可以在 VS2022 中进行 QT 程序的开发了。

因为还不能进行 UI 界面设计,所以说只是理论上。

如果你只开发命令行程序,肯定是没有问题的了。

2、下载 QtCreator 程序

因为 QT 是使用 QtCreator 来创建、编辑界面 (.ui 文件),所以我们还要下载 QtCreator 程序;

不要到 QT 官网去下载,因为 QT 官网的 QtCreator 程序,是一个集成开发环境。是需要授权的。

我们可以到 github 上,下载 QtCreator 程序。它只有新建、编辑界面功能。我们只需要这个功能。

下载地址:https://github.com/qt-creator/qt-creator/releases/download/v14.0.2/qtcreator-windows-x64-msvc-14.0.2.7z

下载下来,解压,保存到磁盘上。

在磁盘任意位置,创建一个文本文件,输入内容:

XML 复制代码
        <?xml version="1.0" encoding="UTF-8"?>
        <ui version="4.0">
         <class>MainWindow</class>
         <widget class="QMainWindow" name="MainWindow">
            <property name="geometry"><rect><x>0</x><y>0</y><width>800</width><height>600</height></rect></property>
            <property name="windowTitle"><string>MainWindow</string></property>
            <widget class="QWidget" name="centralwidget"/>
         </widget>
        </ui>

保存。将这个文本文件后缀名修改为 .ui 。

双击这个 .ui 文件,windows 会弹出打开方式对话框,选择你下载、保存的 qtcreator.exe 程序,并选中始终用这个程序打开。

这样我们就可以使用 qtcreator 程序对 ui 文件(界面)进行界面设计了。

至此,Windows 下,QT 开发环境搭建成功,可以进行程序开发了。

无需复杂的 QtCreator 的安装过程。也无需在 VS2022 中安装 VS QT 插件。

下面2个步骤不是必须的,可按照你自己的习惯来。但你如果采用下面的方法,会给你带来很多方便。

3、编写 CMakeLists.txt 脚本

采用 cmake 的方式,而不是 pro 的方式,当然是这种方式跨平台。而且 cmake 现在几乎算是标准了。

(qt 还提供一个 pro 到 cmake 的小工具:qmake2cmake。Introducing qmake2cmake

这是一个标准的 QT 程序 CMakeLists.txt 脚本:

bash 复制代码
cmake_minimum_required(VERSION 3.5)

#工程文件名称
set(ProjectName "test01")
project(${ProjectName} VERSION 0.1 LANGUAGES CXX)

set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

#文件源码列表
set(PROJECT_SOURCES
        main.cpp
        mainwindow.cpp mainwindow.h
        mainwindow.ui
)

qt_add_executable(${ProjectName} WIN32 MACOSX_BUNDLE MANUAL_FINALIZATION ${PROJECT_SOURCES})
target_link_libraries(${ProjectName} PRIVATE Qt${QT_VERSION_MAJOR}::Widgets)
install(TARGETS ${ProjectName} BUNDLE DESTINATION . LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR} RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})

除了 #工程文件名称、#文件源码列表,不一样外,其它程序都可以套用这个模板。
因为我们用 VCPKG 编译的 QT6 是 MT 类型的静态库,所以上面的脚本需要修改,以符合 VCPKG 编译出来的 QT6 MT静态库;

完整的脚本如下(添加了 MT 编译,和修改了编译使用到的库文件):

bash 复制代码
cmake_minimum_required(VERSION 3.5)

#工程文件名称
set(ProjectName "test01")   
project(${ProjectName} VERSION 0.1 LANGUAGES CXX)

set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

#MT 编译
set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
foreach(flag_var
				CMAKE_C_FLAGS CMAKE_C_FLAGS_DEBUG CMAKE_C_FLAGS_RELEASE
				CMAKE_C_FLAGS_MINSIZEREL CMAKE_C_FLAGS_RELWITHDEBINFO
				CMAKE_CXX_FLAGS CMAKE_CXX_FLAGS_DEBUG CMAKE_CXX_FLAGS_RELEASE
				CMAKE_CXX_FLAGS_MINSIZEREL CMAKE_CXX_FLAGS_RELWITHDEBINFO)
	if(${flag_var} MATCHES "/MD")
		string(REGEX REPLACE "/MD" "/MT" ${flag_var} "${${flag_var}}")
	endif()
	if(${flag_var} MATCHES "/MDd")
		string(REGEX REPLACE "/MDd" "/MT" ${flag_var} "${${flag_var}}")
	endif()
endforeach(flag_var)

find_package(QT NAMES Qt6 REQUIRED COMPONENTS Widgets)
find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets)

#文件源码列表
set(PROJECT_SOURCES
        main.cpp
        mainwindow.cpp mainwindow.h
        mainwindow.ui
)

qt_add_executable(${ProjectName} WIN32 MACOSX_BUNDLE MANUAL_FINALIZATION ${PROJECT_SOURCES})
#vcpkg 的 bug,不能自动找到 bz2 brotlicommon brotlidec 库,手动添加上
target_link_libraries(${ProjectName} PRIVATE Qt${QT_VERSION_MAJOR}::Widgets bz2 brotlicommon brotlidec)
install(TARGETS ${ProjectName} BUNDLE DESTINATION . LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR} RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})

这样,这个编译脚本就完成了。可以正常工作了。

而且它可以算是一个通用 cmake 编译脚本。

你只需修改工程文件名称,和源码列表,就可以用到其它 QT 程序中去,省了你编写 cmake 脚本的麻烦。

4、编写 cmd 批处理编译脚本
在磁盘任意位置,建立 zqt.cmd 批处理文件。内容如下:

bash 复制代码
@echo off
color A

:: 你的 QT 程序源代码目录
set "SourceFilePath=%1"
CD /D %SourceFilePath%

:: 检查 VS2022 安装位置
for %%G in (Community,Professional,Enterprise) do (
  if exist "%ProgramFiles(x86)%\Microsoft Visual Studio\2022\%%G" (
    set "VSInstallPath=%ProgramFiles(x86)%\Microsoft Visual Studio\2022\%%G"
  )
  if exist "%ProgramFiles%\Microsoft Visual Studio\2022\%%G" (
    set "VSInstallPath=%ProgramFiles%\Microsoft Visual Studio\2022\%%G"
  )
)
if "%VSInstallPath%"=="" (
  echo "Visual Studio 2022 not found"
  pause
  goto bEnd
)
call "%VSInstallPath%\VC\Auxiliary\Build\vcvars64.bat"

:: 你的 VCPKG 安装位置
set "VCPKGPTH=D:/vcpkg"

:: VC 的头文件、库文件搜索位置
set "VSQT6SDK=%VCPKGPTH%/installed/x64-windows-static"
set "VSSDKINC=%VSQT6SDK%/include"
set "VSSDKLIB=%VSQT6SDK%/lib"
set "INCLUDE=%VSSDKINC%;%INCLUDE%"
set "LIB=%VSSDKLIB%;%VCToolsInstallDir%atlmfc/lib/X64;%LIB%"
set "UseEnv=True"
set "InstallSDK=../_install"
set "BuildType= -DCMAKE_CONFIGURATION_TYPES=Release -DCMAKE_BUILD_TYPE=Release"
set "Path=%VSQT6SDK%/share;%Path%"

:: 删除临时编译目录,在当前源码目录下
if exist "./x64" (
  rd /S /Q  "./x64"
)

:: 用 VS2022 编译源码,会生成 sln 工程文件
cmake . -B "./x64" %BuildType% -DQT_DIR="%VSQT6SDK%/share/Qt6" -DQt6_DIR="%VSQT6SDK%/share/Qt6" -DCMAKE_INSTALL_PREFIX=%InstallSDK%
cmake "./x64"
cmake --build "./x64" --parallel --config Release --target install

:: 检查编译是否有错误
if %errorlevel% NEQ 0 (
	echo ★★★★★ compile error. ★★★★★ 
	pause
)

cls

:bEnd

这个批处理文件是个通用的文件。你只用修改一下你的 vcpkg 的安装位置就可以了。

在命令行上输入:zqt "你的 qt 程序目录",就可以自动编译了。

也可以将你的 qt 程序源代码目录,鼠标拖放到这个 zqt.cmd 文件上,自动完成编译。

当然你也可以打开 sln 工程文件,编译,修改代码。

总结,这种方法的好处:
1、模板化:cmakelists.txt 编译脚本具有通用性;zqt.cmd 批处理文件一次写成,以后也无需修改。自动完成 qt 程序编译;
2、工程化:会生成 vs2022 的工程文件,sln 文件。你可以像对待 vc 程序一样对待 qt 程序了;
3、静态化:编译的程序是静态链接,没有烦人的动态链接库dll。程序性能有所提高;
4、简单化:比起 QtCreator 和 VS QT,编译过程简单的多了,节省了很多时间。也省了安装配置 QtCreator 和 VS QT 的烦恼;

小瑕疵的完善:

由于vcpkg 编译问题,使得在编译 QT 程序时,会提示找不到 harfbuzz package。

如果你像我一样,有强迫症,不想看见那些警告信息,那就修改 share\harfbuzz\harfbuzz-config.cmake 文件。
https://download.csdn.net/download/dbyoung/89870466?spm=1001.2014.3001.5503

这是我修改好的 harfbuzz-config.cmake 文件,下载,替换一下。就没有烦人的警告了。编译检查一次过,节省了编译时间。

相关推荐
QQ_77813297419 分钟前
2024华为java面经
java·开发语言
qingy_204629 分钟前
JavaScript入门笔记
开发语言·javascript·笔记
MessiGo1 小时前
C++ 编程基础(5)类与对象 | 5.8、面向对象五大原则
开发语言·c++
NiNg_1_2341 小时前
Java爬虫(HttpURLConnection)详解
java·开发语言·爬虫
Root_Smile1 小时前
【C++】static(静态)
开发语言·c++
Thomas_Cai1 小时前
用go语言后端开发速查
开发语言·golang·后端开发
编程修仙2 小时前
java集合—List的底层结构和源码分析
java·开发语言·list
武昌库里写JAVA2 小时前
R语言机器学习与临床预测模型77--机器学习预测常用R语言包
java·开发语言·算法·spring·log4j
旺旺碎冰冰、2 小时前
List、ArrayList与顺序表1
java·开发语言·数据结构·list