安装wxWidgets遭遇的两大关卡

早就想体验wxWidgets。这学期的C++课，课时还算充裕，关键是弟子们的实践能跟得上，我希望能让他们也浅尝一把GUI开发。MFC可以选，但既然IDE都用CodeBlocks了，还是选wxWidgets，开源平台到底吧。
　　要引弟子行，师傅先走一步。
　　最简单的办法，下载wxPack，直接安装。看到安装需要的空间相当大，有些犹豫，一是没有找到合适的下载源（我的浏览器打不开http://sourceforge.net，估计又是移动宽带不能解析域名，懒得找他们了），二也想体验利用下载的源文件，自己编译做些体验。
　　下载了wxWidgets-3.0.0、wxWidgets-2.8.8，老机器编译时间长，还总出问题。几次编译，不是到下班时间，就是到要到开会时间，错在何处，没有静心去看。

　　无端怀疑下载的版本有问题（这个心理很多时候是错的）。偏偏这方面的资料真的不多，能静下心来正视问题之时，下面的工作都是基于wxWidgets-2.8.7做的。

　　顺便交待一下，我用的Code::Block用的是12.11版，GCC版本是4.7.1，操作系统是Win7。

　　下载wxWidgets-2.8.7.exe后安装，其实就是将文件解压缩出来，我将其放在F:/wxWidgets-2.8.7中（读者实践中自换文件夹名即可）。

问题1：编译中“内存耗尽”
　　按照相关材料的提示，
　　（1）在PATH变量中加入F:\Program Files\CodeBlocks\MinGW\bin；
　　（2）打开MS-DOS窗口，将当前目录设置为F:\wxWidgets-2.8.7\build\msw；
　　（3）运行编译wxWidgets的命令：

　　编译方法：

mingw32-make -f makefile.gcc  MONOLITHIC=1 SHARED=1 UNICODE=1 BUILD=debug

　　编译很慢。伤心的是，最后出来的结果，提示error。最后两行的提示是：

gcc_mswuddll\monodll_xh_bmpcbox.o: file not recognized: Memory exhausted
collect2.exe: error: ld returned 1 exit status

　　居然是Memory exhausted！
　　得不到解释，也想不出道道。换了几次关键词搜索，终于找到了http://www.cnblogs.com/aozima/archive/2011/10/03/2198653.html，其中提到“内存耗尽，是因为32位系统最大只能为应用程序分配2G的内存.”我的系统恰也是32位的。
　　怎么解决？
　　解决方法：在编译时加入 -fno-keep-inline-dllexport 参数(内联符号不导出)，这样DLL文件也小了，链接时占用内存也小了。
　　具体步骤：
　　（1）找开F:\wxWidgets-2.8.7\build\msw中的config.gcc文件；
　　（2）修改config.gcc中的几个参数：

UNICODE ?= 1
CPPFLAGS ?= -Os -fno-keep-inline-dllexport
LDFLAGS ?= -s
RUNTIME_LIBS ?= static

　　（3）查看了一下GCC的版本，顺便修改了GCC版本参数

GCC_VERSION ?= 4.7.1

　　再运行。

　　顺利，再没有出现Memory exhausted

问题2：连接中缺少文件

　　利用Code::Blocks提供的向导，生成一个GUI应用，作为体验的开始。

　　步骤按向导做就行。生成的程序要运行，有不少的问题，参考“C?o?d?e?B?l?o?c?k?s?编?译?w?x?W?i?d?g?e?t?s?设?置”，工作得以继续进行。

　　语法错误就此消除，无非就是头文件找不到之类的。

　　而挑战，出现在连接阶段。

　　出现的错误提示是：

ld.exe||cannot find -lwxmsw28d_core|
ld.exe||cannot find -lwxbase28d|
|=== Build finished: 2 errors, 0 warnings (0 minutes, 1 seconds) ===

　　这是找不到库文件。

　　然而，这样的库文件在哪儿呢？

　　查看F:\wxWidgets-2.8.7\lib\gcc_dll中，出现的文件如下：
　　
　　按搜索到的资料，lwxbase28d要对应libwxbase28d.a，期望的文件不存在。
　　这时，必须正视编译时运行的命令中的参数了。
　　编译命令是：

mingw32-make -f makefile.gcc BUILD=release SHARED=1 MONOLITHIC=1 UNICODE=1

　　搜索得知，设置想要如何编译wxWidgets，要编辑文件confg.gcc，以，其中主要设置了如下选项：

SHARED = 1                编译成动态链接库
UNICODE = 1               使用UNICODE（我是中文用户，当然要它了）
BUILD = release           生成正式发行版
MONOLITHIC = 1            生成单一动态链接库

　　其实，作为初体验，懒得琢磨这些参数。
　　换参数BUILD=debug再次编译：

mingw32-make -j2 -f makefile.gcc SHARED=1 BUILD=debug MONOLITHIC=1 UNICODE=1

　　在F:\wxWidgets-2.8.7\lib\gcc_dll中增加的文件是
　　
　　干脆，改SHARED=0 BUILD=release再来，运行

mingw32-make -j2 -f makefile.gcc SHARED=0 BUILD=release MONOLITHIC=1

　　这次，增加了F:\wxWidgets-2.8.7\lib\gcc_lib文件夹，其中的文件是：
　　
　　将F:\wxWidgets-2.8.7\lib\gcc_lib加入到项目的search directories中，Built项目。令人沮丧的是还有错误，而高兴的是，只有cannot find -lwxbase28d了。
　　Build Target现在是“Debug”，试着改为“Release”。再Built项目。好事，通过，没有问题。运行，利用向导生成的项目，正确运行！
　　改回“Debug”，问题依然。我希望我的环境中，能够编译Debug版本的程序，这个问题要解决。
　　然而，观察发现，BUILD=release时，SHARED=0和SHARED=1的两种情况都已经做过，无论用动态链接库，还是用静态链接库，只要是生成正式发行版（release），现有的库函数都已经具备。而缺少的lwxbase28d嘛，从名称上看，这个d正是debug之意。
　　于是，修改参数再编译一遍，这次要生成的是支持静态链接的Debug库文件：

mingw32-make -j2 -f makefile.gcc SHARED=0 BUILD=debug MONOLITHIC=1

　　出现的文件：
　　
　　迫不急待地运行项目。万岁，Build Target是“Debug”时也正常了。
　　记录下这个过程。明天开始可以运行wxWidgets自带的Demo了。找到些感觉后，看书，再试着自己写些小程序，适合我的菜鸟学生做的那种。
　　这个安装过程的经验是：（1）遇到问题不退缩；（2）搞不清和不到搞清参数的时候，就调整参数，多产生些版本出来。其实，好多经验之谈，也是从这种试探中来的。

附：wxWidgets编译选项简介（给想对编译过程更清楚一些的同学）
　　自：http://blog.tianya.cn/blogger/post_show.asp?BlogID=2502562&PostID=25475119

• BUILD

　　BUILD控制wxWidgets构建调试版本（BUILD=debug）或者是发布版本（BUILD=release）。绝大多数情况下你只需要wxWidgets的发布版本就可以了，因为你应该不想要去调试wxWidgets自身，同时你依然可以通过链接wxWidgets的发布版本来构建你自己的程序的调试版本。

• 调试构建wxWidgets会创建带有”d”后缀的库，例如”libwxmsw28d.a”、”wxmsw28d_gcc_custom.dll”。
• 调试构建wxWidgets会在wxWidgets库的输出目录中创建”mswd” 或者 “mswud” 目录。
• 发布构建wxWidgets创建的库没有”d”后缀，例如”libwxmsw28.a”、”wxmsw28_gcc_custom.dll”。
• 发布构建wxWidgets会在wxWidgets库的输出目录中创建”msw” 或者 “mswu” 目录。
• SHARED

　　SHARED控制wxWidgets是构建DLL（SHARED=1）还是静态库（SHARED=0）。利用构建的DLL，主程序构建时间较快，可执行文件更小。但是可执行文件加上wxWidgets DLL的总大小更大，但是不同的可执行文件可以使用同一个DLL。

• wxWidgets的DLL构建会创建导入库（如 libwxmsw28.a）以及DLL文件（如wxmsw28_gcc_custom.dll）。你必须在发布你的程序的时候包含这个DLL。
• wxWidgets的静态构建只会创建静态库（如 libwxmsw28.a），发布的时候也无须包含wxWidgets的DLL。
• MONOLITHIC

　　MONOLITHIC控制是构建一个单一的库（MONOLITHIC=1）还是多个组件库（MONOLITHIC=0）。使用单一构建，项目的设置和开发会更加简单，如果你同时使用DLL构建的话，你只需要分发一个DLL文件。如果使用非单一构建（multilib），会构建出多个不同的库同时你可以避免将整个wxWidgets的基本代码链接到主程序，就可以去掉不需要的库。同时你也必须确保你选择了正确的组件库。

• wxWidgets的单一构建仅会创建一个wxWidgets导入库（如libwxmsw28.a）以及一个DLL（如wxmsw28_gcc_custom.dll）。
• wxWidgets的多库（multilib）构建会创建多个导入库（libwx28_base.a等）以及多个DLL文件。
• 无论何种wxWidgets构建，都会创建额外的静态库（如libwxexpat.a、libwxjpeg.a等）。这些库对于wxWidgets的DLL构建一般是不需要的，但是当使用静态构建的时候，则是必须的。
• UNICODE

　　UNICODE控制wxWidgets以及你的程序是否使用支持Unicode的宽字符串。大多数Windows 2000或更高系统上的应用程序都应该支持Unicode。早期的Windows版本不一定有Unicode支持。你应该总是使用wxWidgets的_("string")和_T("string")宏来确保硬编码的字符串编译时是正确的类型。

• wxWidgets的Unicode（UNICODE=1）构建将会创建带有”u”后缀的库，例如”libwxmsw28u.a”、”wxmsw28u_gcc_custom.dll”。
• wxWidgets的Unicode构建会在wxWidgets库的输出目录中创建”mswu”或”mswud”目录。
• wxWidgets的ANSI（UNICODE=0）构建创建的库没有”u”后缀，例如”libwxmsw28.a”、”wxmsw28_gcc_custom.dll”。
• wxWidgets的ANSI构建会在wxWidgets库的输出目录中创建”msw”或”mswd”目录。
• 常见问题
• 出现类似于”wx/setup.h: No such file or directory”的错误：你在构建选项中缺少了很重要的编译器搜索路径。首先确认你是否在运行wxWidgets项目向导的时候正确选择了wxWidgets的构建配置。如果重新运行向导并配置依然无效，那么打开你的项目的构建选项并给编译起的搜索路径中添加”$(#wx.lib)\gcc_dll\mswu“（这里假设是一个单一的Unicode DLL构建）。
• 出现类似于”cannot find -lwxmsw28u”的错误：构建选项中的链接库错了。首先确认你是否在运行wxWidgets项目向导的时候正确选择了wxWidgets的构建配置。如果重新运行向导并配置依然无效，确定你构建了什么库，并相应在构建选项中调整库的名字。

================= 迂者 贺利坚 CSDN博客专栏=================
|==　IT学子成长指导专栏　专栏文章的分类目录（不定期更新）　==|
|==　C++ 课堂在线专栏　　贺利坚课程教学链接（分课程年级）　==|
|==　我写的书——《逆袭大学——传给IT学子的正能量》　　　　==|
===== 为IT菜鸟起飞铺跑道，和学生一起享受快乐和激情的大学 =====

安装wxWidgets遭遇的两大关卡