配置本身的OpenGL库，glew、freeglut库编译，库冲突解决（附OpenGL Demo程序）

 

平台：Windows7，Visual C++ 2010

 

1. 引言

    实验室的一个项目，用到OpenGL进行实时绘制，还用到一些其余的库，一个困扰我好久的问题就是编译时遇到的各类符号未定义，符号重定义之类的连接错误，其通常形式以下：

xxx.obj : error LNK2019: 没法解析的外部符号__xx_xxx@xx，该符号在函数 _xxx 中被引用

MSVCRTD.lib(ti_inst.obj) : error LNK2005: "private: class type_info & __thiscall type_info::operator=(class type_info const &)" (??4type_info@@AAEAAV0@ABV0@@Z) 已经在 LIBCMTD.lib(typinfo.obj) 中定义

    简单的说，这种问题通常是缺乏库（library，或库的版本不对）或多个库引用的CRT（C run-time library，C语言运行库）不一致形成的。本文对这一问题作简要探讨，并用glew、freeglut库的配置做为例子。

 

2. 静态连接库、动态连接库、CRT、STL

    咱们要到一个函数，要么是须要该函数的源代码，要么是知道该函数的声明并有该函数的实现，这里的“实现”又分为静态连接库、动态连接库。在windows平台上，静态连接库对应以.lib为后缀的库文件，动态连接库对应.dll为后缀的动态连接库文件。关于静态连接库、动态连接库请参考wikipedia相应条目：

http://en.wikipedia.org/wiki/Static_library
http://en.wikipedia.org/wiki/Dynamic-link_library

    咱们用VC++写的程序默认编译为可执行文件（.exe），若是想发布本身的库，能够在VS的“项目属性 >> 配置属性 >> 常规 >> 配置类型”修改。这样若是之后想用这些函数就不须要引入对应.cpp文件，而只需包含带有该函数声明的头文件，并引用库文件便可——对于静态连接库，能够用“#pragma comment (lib, "xxx.lib")”指令，或在VS的“项目属性 >> 配置属性 >> 连接器 >> 输入 >> 附加依赖”中添加；对于动态连接库，能够用“__declspec(dllimport)”声明要用的函数，若是为.dll文件实现了导入库（对应的.lib文件，里面实现了函数导入，使用同静态连接库），则动态库的使用同静态库，只是程序执行时须要.dll文件。msdn上有静态库和动态库的使用教程：

http://msdn.microsoft.com/en-us/library/ms235627.aspx
http://msdn.microsoft.com/en-us/library/ms235636.aspx

    简单总结，可执行文件（.exe）和库文件（.lib、.dll）都含有源代码编译出来的可执行二进制代码。静态连接和动态连接的区别在于：静态连接编译出的可执行代码体积较大，动态连接编译出的可执行代码执行时依赖对应的.dll文件。

    CRT（C语言运行库）实现了C语言相关初始化代码以及实现了C函数库，C++能够看作C语言的超集，因此C++并无“CPRT（C++运行库）”，C++也使用CRT，标准C++除CRT外还实现了STL（standard C++ library，C++标准库，注意STL是Standard Template Library的缩写，由于C++标准库主要是用模板实现的）。既然函数的“实现”至少有静态和动态之分，那CRT或STL也有不止一个版本，后文针对VC2010平台讨论这些版本。

    总结，CRT是C语言函数库及初始化代码的实现，STL是C++标准库的实现，所谓“实现”就是由源代码编译出来的.lib、.dll文件等。

 

3. VS的编译选项

    在VC2010上，CRT和STL至少分为静态和动态，静态和动态中又各自有Debug和Release版本（早期VC还有单线程和多线程之分，目前VC++中只提供多线程版本），这样CRT和STL都有至少四个版本。如今来解释引言中的符号未定义、符号重定义连接错误的可能情景，程序A中调用了函数f，函数f是在程序B中编写的，为了使用f，将程序B编译为库（而非.exe）——静态库：B.lib\动态库：B.lib、B.dll，程序A为了使用f，包含头文件B.h（其中有函数f的声明）并引用B.lib：

1 #include"B.h"
2 #pragma comment (lib, "B.lib")

    若是没有上面的第二句代码，则出现了符号未定义的连接错误：

main.obj : error LNK2019: 没法解析的外部符号 _f@0，该符号在函数 _main 中被引用

    上面错误信息中的“_f@0”具体取决于函数调用约定的命名方式（_cdecl、_stdcall等）。

    若是编译程序B时使用了动态版本的CRT而编译A时使用的是静态版本CRT（即A、B使用了不一样版本的CRT），则出现了符号重定义之类的连接错误（不绝对）。

    固然若是用动态连接版本的B，程序A运行时可执行文件搜索路径中必须包含B.dll，不然报告“丢失xxx.dll”之类的错误。

    设置程序到底使用哪一个版本的CRT可在VS的“项目属性 >> 配置属性 >> C/C++ >> 代码生成 >> 运行库”中设置，如今将几种设置对应的库文件，编译器的宏定义列在下表：

Option	Preprocessor directives	C run-time library (without iostream or standard C++ library)	Standard C++ Library
/MT	_MT	libcmt.lib	LIBCPMT.LIB
/MD	_MT, _DLL	msvcrt.lib (import library for MSVCR100.DLL)	MSVCPRT.LIB (import library for MSVCP100.dll)
/MTd	_DEBUG, _MT	libcmtd.lib	LIBCPMTD.LIB
/MDd	_DEBUG, _MT, _DLL	msvcrtd.lib (import library for MSVCR100D.DLL)	MSVCPRTD.LIB (import library for MSVCP100D.DLL)

    其中，MT为是multi-thread的缩写，上面说了，全部这些库都是多线程的，大写D表明DLL，小写d表明debug，如/MDd下引用动态连接调试版本的库，而且编译器定义宏_DEBUG, _MT, _DLL（程序中能够用#ifdef指令来判断库版本），引用的CRT实现文件为MSVCPRTD.LIB，该文件只是导入库并无具体的执行二进制代码，程序运行时动态连接MSVCP100D.DLL文件，STL实现文件同理。

    文件名“MSVC[R,P]100[D]”中的“100”对应VC2010，VC200三、VC200五、VC200八、VC20十、VC2012分别为7一、80、90、100、110，有些时候咱们运行一个程序提示“丢失msvcrxxx.dll”，能够经过安装对应VS来解决，若是不想安装VS，也可经过安装“Microsoft Visual C++ 20xx [SP1] Redistributable Package”来解决。

    可参考msdn的C run-time libraries条目：

http://msdn.microsoft.com/en-us/library/vstudio/abx4dbyh(v=vs.100).aspx

 

4. 编译glew

    可到如下地址下载最新glew：

http://glew.sourceforge.net/

    解压后打开...\glew-1.10.0\build\vc10\glew.sln文件，能够看到有“glew_shared”和“glew_static”两个项目，从右键属性中能够看到它们分别生成动态和静态的库：

    还能够看到debug和release配置下分别使用相应debug和release版本CRT：

    博文写到这里，发现一个问题，“glew_static”应该使用静态版本的CRT，但从上图看到，release下是静态连接（/MT），但debug下怎么不是“/MTd”呢？（后面会进一步分析）

    在使用glew是须要包含相应头文件，并连接相应库文件，将上面生成的四个版本的库文件拷贝出来：

    其中文件名中的s表明static，即静态连接，d表明debug，即调试版本，不带s的是动态连接版本，不带d的是release版本，文件名能够从glew工程的配置“项目属性 >> 常规 >> 目标文件名”中看到：

    而后将...\glew-1.10.0\include\GL\下头文件拷贝出来：

    将头文件所在路径添加到到VC2010项目包含目录中，有两种方法：“项目属性 >> 配置属性 >> VC++目录 >> 包含目录”或“项目属性 >> 配置属性 >> C/C++ >> 常规 >> 附加包含目录”，将库文件所在路径添加到到VC2010项目库目录中，也有两种方法：“项目属性 >> 配置属性 >> VC++目录 >> 库目录”或“项目属性 >> 配置属性 >> 连接器 >> 常规 >> 附加库目录”。

    经过判断CRT版原本引用不一样库（这样避免CRT版本不一致）：

 1 #ifdef _DLL // dynamic link
 2 　　#ifdef _DEBUG
 3 　　　　#pragma comment (lib, "glew32d.lib")
 4 　　　　#pragma comment (lib, "freeglutd.lib")
 5 　　#else
 6 　　　　#pragma comment (lib, "glew32.lib")
 7 　　　　#pragma comment (lib, "freeglut.lib")
 8 　　#endif
 9 #else // static link
10 　　#ifdef _DEBUG
11 　　　　#pragma comment (lib, "glew32sd.lib")
12 　　　　#pragma comment (lib, "freeglutsd.lib")
13 　　#else
14 　　　　#pragma comment (lib, "glew32s.lib")
15 　　　　#pragma comment (lib, "freegluts.lib")
16 　　#endif
17 　　#define GLEW_STATIC
18 　　#define FREEGLUT_STATIC
19 #endif
20 #include "GL/glew.h"
21 #include "GL/freeglut.h"

    上述代码利用编译器在不一样配置（/MT、/MD、/MTd、/MDd）下内置的不一样宏来判断使用的CRT版本，并引用对应版本glew和freeglut库版本。

    这样配置后编译本身的程序不会再出现引言中的连接错误了，但有不少以下警告：

glew32s.lib(glew.obj) : warning LNK4099: 未找到 PDB“vc100.pdb”(使用“glew32s.lib(glew.obj)”或在“C:\Users\hll\Desktop\fluid 2014.01\Release\vc100.pdb”中寻找)；正在连接对象，如同没有调试信息同样

    将glew工程配置成不生成调试信息，或把调试信息直接生成到.obj文件中（而非.pdb文件）便可，“项目属性 >> 配置属性 >> C/C++ >> 常规 >> 调试信息格式”，空表示不生成调试信息，C7把调试信息直接生成到.obj文件中，默认的Zi生成.pdb文件：

    接着上面说到的“glew_static”的配置问题（往上找那段绿色的话），在本身工程配置为“/MTd”时引用glew32sd.lib库程序报错以下：

1>------ 已启动生成: 项目: exampleGL, 配置: Debug_static Win32 ------
1>生成启动时间为 2014/1/15 17:42:55。
1>InitializeBuildStatus:
1> 正在对“Debug_static\exampleGL.unsuccessfulbuild”执行 Touch 任务。
1>ClCompile:
1> 全部输出均为最新。
1>ManifestResourceCompile:
1> 全部输出均为最新。
1>MSVCRTD.lib(ti_inst.obj) : error LNK2005: "private: __thiscall type_info::type_info(class type_info const &)" (??0type_info@@AAE@ABV0@@Z) 已经在 LIBCMTD.lib(typinfo.obj) 中定义
1>MSVCRTD.lib(ti_inst.obj) : error LNK2005: "private: class type_info & __thiscall type_info::operator=(class type_info const &)" (??4type_info@@AAEAAV0@ABV0@@Z) 已经在 LIBCMTD.lib(typinfo.obj) 中定义
1>LINK : warning LNK4098: 默认库“MSVCRTD”与其余库的使用冲突；请使用 /NODEFAULTLIB:library
1>C:\Users\hll\Desktop\exampleGL\Debug_static\exampleGL.exe : fatal error LNK1169: 找到一个或多个多重定义的符号
1>
1>生成失败。
1>
1>已用时间 00:00:00.38
========== 生成: 成功 0 个，失败 1 个，最新 0 个，跳过 0 个 ==========

    利用上面VC2010编译配置表（往上找加粗的表），配置为“/MTd”使用的是库libcmtd.lib，而msvcrtd.lib是“/MDd”配置下使用的库，解决上述符号重定义错误的一个方法以下：

#pragma comment (linker, "/NODEFAULTLIB:MSVCRTD.lib")

    但很明显，这不是漂亮的解决方法，若是咱们“擅自”将“glew_static”的上述配置“/MDd”改成“/MTd” （仍是往上找那段绿色的话），这个问题也会消失，看来这多是glew发布版（1.10.0）的一个bug（除了刚分析的“glew_static” debug的配置“/MDd”改成“/MTd”，还有一处，“glew_shared” release的配置“/MT”改成“/MD”），但这正好成就了咱们对本文技术分析结果的完美应用~

 

5. 编译freeglut

    可到如下地址下载最新freeglut：

http://freeglut.sourceforge.net/

    有了glew编译经验，以及本身的工程配置经验以后，freeglut的编译这里就简单些说了。

    解压后打开...\freeglut-2.8.1\VisualStudio\2010\freeglut.sln文件，能够看到它的配置略有不一样：

    再随便打开一个CRT配置能够看到：

    freeglut并无像glew那样在CRT配置上出现小bug（仍是往上找那段绿色的话）。

    好了，像glew同样，用配置管理器的4个选项（debug、release、debug_static、release_static，分别对应4个CRT版本）分别编译出4个版本的库（6个文件，4个.lib，2个.dll），但freeglut并无像glew那样将4个版本的文件分别命名用或不用s及d结尾，它的debug版和release版文件名相同，我只好本身改啦（这一改带来不少问题）：

    改成：

    其余类推，并将freeglut_std.h文件中以下代码：

...
#　　　　pragma comment (lib, "freeglut_static.lib")
...
#　　　　　　pragma comment (lib, "freeglut.lib")
...

    修改成：

...
#　　　　ifdef _DEBUG
#　　　　　　pragma comment (lib, "freeglutsd.lib")
#　　　　else
#　　　　　　pragma comment (lib, "freegluts.lib")
#　　　　endif
...
#　　　　　　ifdef _DEBUG
#　　　　　　　　pragma comment (lib, "freeglutd.lib")
#　　　　　　else
#　　　　　　　　pragma comment (lib, "freeglut.lib")
#　　　　　　endif
...

    修改依据相同，仍是根据CRT的4个版本引用4个版本的.lib文件。注意，我以前在freeglut项目中只作了“目标文件名”的修改，而未作.h文件的上述修改来编译freeglut（只是将.h文件拷贝出来后才修改，这样本身项目包含的是修改后的freeglut_std.h文件，而编译freeglut用的是原版），这样的结果是，生成出来的.lib文件内部仍在引用"freeglut_static.lib"（而不是"freegluts.lib"），用二进制打开生成的.lib文件以下：

    而使用修改后的freeglut_std.h文件编译freeglut结果以下：

    使用未修改的freeglut_std.h文件生成"freegluts.lib" 后，本身工程包含修改后的freeglut_std.h，按说只引用"freegluts.lib"，但连接器仍报告找不到"freeglut_static.lib"文件。

    另一个相似的问题是，当编译动态连接debug版本的库时，生成文件为freeglutd.dll和freeglutd.lib（名字规则：非静态不带s，debug带d），头文件中引用"freeglutd.lib"将freeglutd.dll拷贝到VC2010自动生成的debug文件夹下（和本身工程生成的.exe文件同一文件夹），运行程序结果报告“丢失freeglut.dll”（不带我本身修改后的名字的d），编译freeglut生成的.lib和.dll文件名为freeglutd，但.lib文件内部引用的.dll文件名为freeglut（不带d），验证以下：

    通过一番研究， freeglut的配置下，freeglutd.lib文件是连接器根据一个.def文件生成的（glew的导入库配置在“项目属性 >> 配置属性 >> 连接器 >> 高级 >> 导入库”）：

    .def文件内容以下：

    经查，第一行“LIBRARY freeglut”的含义正是“引用freeglut.dll”，将该句去掉，连接器生成的.lib文件引用的.dll文件自动和生成的.dll文件同名，问题解决：

    另外值得一提的是当生成动态连接版本的.dll文件时，用到了一个资源文件，其内容以下（glew中的）：

 

6. 搭建OpenGL工程

    工程原则：将glew和freeglut库放在工程文件夹下以免对环境依赖、不能出现任何关于库冲突等警告（错误固然更不能够）、根据CRT的4个版本定义4个配置（debug，release，debug_static，release_static）。

    将上面的glew和freeglut的编译总结在下面：

glew—

1.bug修复，“glew_static” debug的配置“/MDd”改成“/MTd”，“glew_shared” release的配置“/MT”改成“/MD”

2.不生成调试信息，“glew_static”和“glew_shared”全部配置下的“调试信息格式”改成空

3.对“glew_static” debug及release 和 “glew_shared” debug及release分别编译，获得glew32sd.lib、glew32s.lib、glew32d.lib(glew32d.dll)、glew32.lib(glew32.dll)

freeglut—

1.生成目标文件名修改，“freeglut”的“目标文件名”项原来为$(ProjectName)和$(ProjectName)_static，4个配置debug、release、debug_static、release_static分别改成$(ProjectName)d、$(ProjectName)、$(ProjectName)sd、$(ProjectName)s

2.不生成调试信息，“freeglut”全部配置下的“调试信息格式”改成空

3.freeglut_std.h文件修改如上述

4.freeglutdll.def文件删去第一行的“LIBRARY freeglut”

5.对“freeglut”的4个配置debug、release、debug_static、release_static分别编译，获得freeglutsd.lib、freegluts.lib、freeglutd.lib(freeglutd.dll)、freeglut.lib(freeglut.dll)

    以下构造文件夹tool：

tool
　　freeglut-2.8.1
　　　　bin
　　　　　　freeglut.dll, freeglutd.dll
　　　　inc
　　　　　　GL
　　　　　　　　freeglut.h, freeglut_ext.h, freeglut_std.h, glut.h
　　　　lib
　　　　　　freeglut.lib, freeglutd.lib, freegluts.lib, freeglutsd.lib
　　glew-1.10.0
　　　　bin
　　　　　　glew32.dll, glew32d.dll
　　　　inc
　　　　　　GL
　　　　　　　　glew.h, glxew.h, wglew.h
　　　　lib
　　　　　　glew32.lib, glew32d.lib, glew32s.lib, glew32sd.lib

    以下构造VC2010工程：

新建VS C++控制台项目，将上面tool文件夹拷贝到解决方案文件夹下

打开配置管理器，添加Debug_static（从Debug复制）和Release_static（从Release复制）配置

将Debug、Debug_static、Release、Release_static的“运行库”分别配置为：/MDd、/MTd、/MD、/MT

在VS“项目属性 >> 配置属性 >> VC++目录 >> 包含目录”全部配置下添加以下项

$(SolutionDir)tool\glew-1.10.0\inc
$(SolutionDir)tool\freeglut-2.8.1\inc

在VS“项目属性 >> 配置属性 >> VC++目录 >> 库目录”全部配置下添加以下项

$(SolutionDir)tool\glew-1.10.0\lib
$(SolutionDir)tool\freeglut-2.8.1\lib

添加文件gl_inc.h以下：

添加main.cpp以下：

 

    程序运行结果截图：

 

    考虑到方便本文的读者作实验，现将搭建的OpenGL工程exampleGL贡献出来（庸俗的代码水准让你们见笑了）：

 连接: http://pan.baidu.com/s/1kTuPUQz 密码: jiky

 

7. 总结

    在VC++上，CRT和STL有4个版本，分别对应编译选项：/MDd、/MTd、/MD、/MT；

    根据编译选项的不一样，开源程序编译出的库也分为多个版本（通常较全面的是4个，没有4个的能够手动添加配置），这些版本连接不一样的CRT；

    应根据本身程序的编译选项（用编译器预置宏来判断）连接对应的开源库，不然颇有可能出现符号未定义、符号重定义的连接错误。