今天用Qt写了个小程序,拷到另一台电脑发现无法运行,缺少文件。查了一下资料,发现是动态链接库的问题,因为原来一直用的微软系列的开发工具,这个问题不怎么突出,现在用Qt写程序,这个问题就很麻烦了。

    针对这个问题网上找到的资料有两种解决方法,一是将程序需要的库文件放在一起,这个显然很麻烦,而且个人很不喜欢这种方式;另一种就是静态编译,所谓静态编译,就是编译器在编译可执行文件的时候,将可执行文件需要调用的对应动态链接库中的部分提取出来,链接到可执行文件中去,使可执行文件在运行的时候不依赖于动态链接库

    下面介绍一下我自己编译静态库的过程,网上资料不少,但是介绍的都不全面,加上我这方面的基础也不怎么样,着实花了一番功夫。不多废话,开始介绍:


1、下载Qt5.3.1的源码:qt-everywhere-opensource-src-5.3.1.zip

打开官网下载页面,点击红线画着的文字“zip”下载源码:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt

保存图片,改后缀为7z,有下载网址



2、安装python

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_02

保存图片,改后缀为7z,有下载网址



3、下载完成后解压,注意硬盘的可用空间:

我的解压目录是:E:\Qt

这是我编译完的文件夹大小(包括编译目录和install目录):

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_03



4、根据你的VS版本进入相应的文件夹,我是win32-msvc2013:

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_04

进入E:\Qt\qt-everywhere-opensource-src-5.3.1\qtbase\mkspecs\win32-msvc2013目录,有两个文件:

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_05

打开qmake.conf,修改内容并保存,如下:

原内容:


QMAKE_CFLAGS_RELEASE    = -O2 -MD
QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO += -O2 -MD -Zi
QMAKE_CFLAGS_DEBUG      = -Zi -MDd

修改为:


QMAKE_CFLAGS_RELEASE    = -O2 -MT
QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO += -O2 -MT -Zi
QMAKE_CFLAGS_DEBUG      = -Zi -MTd



即将MD(动态)改为MT(静态)。





5、我的电脑装的是VS2013,由开始菜单打开Windows Studio Tools,选择画红线VS2013开发人员命令提示

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_06

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_07



6、在“VS2013开发人员命令提示”窗口中输入python:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_08

如果向上图一样不认命令,说明环境变量未配置:

输入:


set PATH=%PATH%;F:\Program Files\Python33

注:F:\Program Files\Python33是Python的安装目录(与我的肯定不同,我不是安装在默认位置的,默认位置是C:\Python33)


再次输入python,如下图就OK了:

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_09

按下“Ctrl+z”,再回车,退出Python:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_10


转至Qt解压目录,我的是:E:\Qt\qt-everywhere-opensource-src-5.3.1

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_11


关键步骤

执行configure:

输入:


configure -confirm-license -opensource -platform win32-msvc2013 -debug-and-release -static -prefix "E:\Qt\5.3.1-static-vs2013" -qt-sql-sqlite -qt-sql-odbc -plugin-sql-sqlite -plugin-sql-odbc -qt-zlib -qt-libpng -qt-libjpeg -opengl desktop -qt-freetype -no-qml-debug -no-angle -nomake tests -nomake examples -skip qtwebkit



其中”E:\Qt\5.3.1-static-vs2013“为编译完后的安装目录。

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_12

回车执行,一会后执行完毕:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_13



7、接下来,执行nmake:

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_14


回车,然后是漫长的等待,估计2个多小时吧,因为我晚上执行后就去睡了,具体多少时间不清楚。



8、nmake完成,整个过程没出什么错,接着就可以install了,输入nmake install命令:



至此Qt5.3.1的静态库静态库编译完成,接下去就是测试能不能使用了。



9、打开Qt Creator5.3,工具->选项->构建路径->Qt Versions->添加刚才的安装目录:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_15



10、切换到 构建套件(Kit)选项卡,添加,这里我取名为”Qt 5.3 static“,更改”Qt 版本“为刚才添加的编译完的静态版

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_16




11、新建一个Qt Widgets Application:

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_17


一路默认配置,下一步:

在配置Kit的时候会显示两个,Static就是静态版的,为了做对比,两个都勾选:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_18



12、先用动态的编译(debug和release):

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_19



13、再用静态的编译(同样debug和release):

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_20


下面是静态编译debug版时的编译输出,我们看到启动的是E盘下面的qmake,也就是我们编译输出的静态链接库:


08:16:16: 为项目untitled执行步骤 ...
08:16:16: 正在启动 "E:\Qt\5.3.1-static-vs2013\bin\qmake.exe" F:\WorkSpace\Qt\untitled\untitled.pro -r -spec win32-msvc2013

08:16:17: 进程"E:\Qt\5.3.1-static-vs2013\bin\qmake.exe"正常退出。
08:16:17: 正在启动 "F:\Qt_VS2013_Opengl_x86\Tools\QtCreator\bin\jom.exe" 

	F:\Qt_VS2013_Opengl_x86\Tools\QtCreator\bin\jom.exe -f Makefile.Debug
	E:\Qt\5.3.1-static-vs2013\bin\uic.exe ..\untitled\mainwindow.ui -o ui_mainwindow.h
	cl -c -nologo -Zm200 -Zc:wchar_t -FS -Zi -MTd -GR -W3 -w34100 -w34189 -EHsc /Fddebug\untitled.pdb -DUNICODE -DWIN32 -DQT_WIDGETS_LIB -DQT_GUI_LIB -DQT_CORE_LIB -I"E:\Qt\5.3.1-static-vs2013\include" -I"E:\Qt\5.3.1-static-vs2013\include\QtWidgets" -I"E:\Qt\5.3.1-static-vs2013\include\QtGui" -I"E:\Qt\5.3.1-static-vs2013\include\QtCore" -I"debug" -I"." -I"." -I"E:\Qt\5.3.1-static-vs2013\mkspecs\win32-msvc2013" -Fodebug\ @C:\Users\Kaven\AppData\Local\Temp\main.obj.1064.0.jom
main.cpp
	cl -c -nologo -Zm200 -Zc:wchar_t -FS -Zi -MTd -GR -W3 -w34100 -w34189 -EHsc /Fddebug\untitled.pdb -DUNICODE -DWIN32 -DQT_WIDGETS_LIB -DQT_GUI_LIB -DQT_CORE_LIB -I"E:\Qt\5.3.1-static-vs2013\include" -I"E:\Qt\5.3.1-static-vs2013\include\QtWidgets" -I"E:\Qt\5.3.1-static-vs2013\include\QtGui" -I"E:\Qt\5.3.1-static-vs2013\include\QtCore" -I"debug" -I"." -I"." -I"E:\Qt\5.3.1-static-vs2013\mkspecs\win32-msvc2013" -Fodebug\ @C:\Users\Kaven\AppData\Local\Temp\untitled_plugin_import.obj.1064.16.jom
	E:\Qt\5.3.1-static-vs2013\bin\moc.exe -DUNICODE -DWIN32 -DQT_WIDGETS_LIB -DQT_GUI_LIB -DQT_CORE_LIB -D_MSC_VER=1800 -D_WIN32 -IE:/Qt/5.3.1-static-vs2013/mkspecs/win32-msvc2013 -IF:/WorkSpace/Qt/untitled -IE:/Qt/5.3.1-static-vs2013/include -IE:/Qt/5.3.1-static-vs2013/include/QtWidgets -IE:/Qt/5.3.1-static-vs2013/include/QtGui -IE:/Qt/5.3.1-static-vs2013/include/QtCore -I. ..\untitled\mainwindow.h -o debug\moc_mainwindow.cpp
untitled_plugin_import.cpp
	cl -c -nologo -Zm200 -Zc:wchar_t -FS -Zi -MTd -GR -W3 -w34100 -w34189 -EHsc /Fddebug\untitled.pdb -DUNICODE -DWIN32 -DQT_WIDGETS_LIB -DQT_GUI_LIB -DQT_CORE_LIB -I"E:\Qt\5.3.1-static-vs2013\include" -I"E:\Qt\5.3.1-static-vs2013\include\QtWidgets" -I"E:\Qt\5.3.1-static-vs2013\include\QtGui" -I"E:\Qt\5.3.1-static-vs2013\include\QtCore" -I"debug" -I"." -I"." -I"E:\Qt\5.3.1-static-vs2013\mkspecs\win32-msvc2013" -Fodebug\ @C:\Users\Kaven\AppData\Local\Temp\mainwindow.obj.1064.47.jom
mainwindow.cpp
	cl -c -nologo -Zm200 -Zc:wchar_t -FS -Zi -MTd -GR -W3 -w34100 -w34189 -EHsc /Fddebug\untitled.pdb -DUNICODE -DWIN32 -DQT_WIDGETS_LIB -DQT_GUI_LIB -DQT_CORE_LIB -I"E:\Qt\5.3.1-static-vs2013\include" -I"E:\Qt\5.3.1-static-vs2013\include\QtWidgets" -I"E:\Qt\5.3.1-static-vs2013\include\QtGui" -I"E:\Qt\5.3.1-static-vs2013\include\QtCore" -I"debug" -I"." -I"." -I"E:\Qt\5.3.1-static-vs2013\mkspecs\win32-msvc2013" -Fodebug\ @C:\Users\Kaven\AppData\Local\Temp\moc_mainwindow.obj.1064.328.jom
moc_mainwindow.cpp
	echo 1 /* CREATEPROCESS_MANIFEST_RESOURCE_ID */ 24 /* RT_MANIFEST */ "debug\\untitled.exe.embed.manifest">debug\untitled.exe_manifest.rc
	if not exist debug\untitled.exe if exist debug\untitled.exe.embed.manifest del debug\untitled.exe.embed.manifest
	if exist debug\untitled.exe.embed.manifest copy /Y debug\untitled.exe.embed.manifest debug\untitled.exe_manifest.bak
	link /NOLOGO /DYNAMICBASE /NXCOMPAT /DEBUG /SUBSYSTEM:WINDOWS "/MANIFESTDEPENDENCY:type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' publicKeyToken='6595b64144ccf1df' language='*' processorArchitecture='*'" /MANIFEST /MANIFESTFILE:debug\untitled.exe.embed.manifest /OUT:debug\untitled.exe @C:\Users\Kaven\AppData\Local\Temp\untitled.exe.1064.2496.jom
   正在创建库 debug\untitled.lib 和对象 debug\untitled.exp
	if exist debug\untitled.exe_manifest.bak fc /b debug\untitled.exe.embed.manifest debug\untitled.exe_manifest.bak >NUL || del debug\untitled.exe_manifest.bak
	if not exist debug\untitled.exe_manifest.bak rc.exe /fodebug\untitled.exe_manifest.res debug\untitled.exe_manifest.rc
Microsoft (R) Windows (R) Resource Compiler Version 6.3.9600.16384

Copyright (C) Microsoft Corporation.  All rights reserved.


	if not exist debug\untitled.exe_manifest.bak link /NOLOGO /DYNAMICBASE /NXCOMPAT /DEBUG /SUBSYSTEM:WINDOWS "/MANIFESTDEPENDENCY:type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' publicKeyToken='6595b64144ccf1df' language='*' processorArchitecture='*'" /MANIFEST /MANIFESTFILE:debug\untitled.exe.embed.manifest /OUT:debug\untitled.exe @C:\Users\Kaven\AppData\Local\Temp\untitled.exe.1064.2512.jom
   正在创建库 debug\untitled.lib 和对象 debug\untitled.exp
	if exist debug\untitled.exe_manifest.bak del debug\untitled.exe_manifest.bak
08:16:34: 进程"F:\Qt_VS2013_Opengl_x86\Tools\QtCreator\bin\jom.exe"正常退出。
08:16:34: Elapsed time: 00:18.



打开项目路径,内容如下:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_21


同样的源代码,编译后的结果比较:

先看debug版:

静态:大小只有82k

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_22

动态:21.5M

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_23


再看release版:

动态:23.5k

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_24

静态:9.33M

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_25


这4个程序的功能都一样,就是弹出一个窗口:

但是你会发现将4个文件单独复制出来,双击运行,动态生成的是无法在未安装Qt链接库环境的电脑上运行的:

我虽然装了Qt,但是没有设置环境变量,所以动态编译的单文件(无论是debug版还是release版)还是无法运行,错误如下:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_26


但是,静态编译的就不同了,在任何一台普通电脑上,直接就能运行,当然代价是执行文件变大:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_27



14、最后,用VS2013编译源文件,需要安装一个Qt插件,

详见:


打开VS2013,添加静态库的目录:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_28


Qt学习(六) VS2013编译Qt5.3.1的静态库_Qt_29


导入刚才那个用Qt Creator创建的弹出窗口的工程:

Qt学习(六) VS2013编译Qt5.3.1的静态库_静态库_30


导入时的输出信息:


--- (Import): Generating new project of untitled.pro file
--- (qmake) : Using: e:\qt\5.3.1-static-vs2013\bin\qmake
--- (qmake) : Working Directory: F:\WorkSpace\Qt\untitled
--- (qmake) : Arguments: -tp vc "untitled.pro" -o "untitled.vcxproj" QMAKE_INCDIR_QT=$(QTDIR)\include QMAKE_LIBDIR=$(QTDIR)\lib QMAKE_MOC=$(QTDIR)\bin\moc.exe QMAKE_QMAKE=$(QTDIR)\bin\qmake.exe

--- (qmake) : Exit Code: 0

--- (Import): Added untitled.vcxproj to Solution

=== Update uic steps ===
Update uic step for mainwindow.ui.

=== 1 uic steps updated. ===


=== Update rcc steps ===

=== 0 rcc steps updated. ===



Ctrl+F5,成功弹出一个窗口:


还原 NuGet 程序包时出错: System.ArgumentException: 路径的形式不合法。
   在 System.IO.Path.NormalizePath(String path, Boolean fullCheck, Int32 maxPathLength, Boolean expandShortPaths)
   在 System.IO.Path.GetDirectoryName(String path)
   在 NuGet.VisualStudio.VsUtility.GetNuGetSolutionFolder(Solution solution)
   在 NuGet.VsEvents.PackageRestorer.UsingOldPackageRestore(Solution solution)
   在 NuGet.VsEvents.PackageRestorer.BuildEvents_OnBuildBegin(vsBuildScope Scope, vsBuildAction Action)。
1>------ 已启动生成:  项目: untitled, 配置: Debug Win32 ------
1>  Moc'ing mainwindow.h...
1>  Uic'ing mainwindow.ui...
1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\Microsoft.CppBuild.targets(935,5): warning MSB8027: Two or more files with the name of moc_mainwindow.cpp will produce outputs to the same location. This can lead to an incorrect build result.  The files involved are GeneratedFiles\Debug\moc_mainwindow.cpp, GeneratedFiles\Release\moc_mainwindow.cpp.
1>  moc_mainwindow.cpp
1>  main.cpp
1>  mainwindow.cpp
1>  untitled_plugin_import.cpp
1>  正在生成代码...
1>     正在创建库 debug\\untitled.lib 和对象 debug\\untitled.exp
1>  untitled.vcxproj -> F:\WorkSpace\Qt\untitled\debug\untitled.exe
========== 生成:  成功 1 个,失败 0 个,最新 0 个,跳过 0 个 ==========






OK,这篇文章终于写完了,稍后我会将编译好的静态库传至网盘,有需要的可以自行下载。


Qt 5.3.1 静态链接库:

Qt学习(六) VS2013编译Qt5.3.1的静态库_Windows_31

(保存链接图片,改扩展名为.7z,即为下载地址)