2020-05-17 10:45:16 +00:00
配置Codeblocks下的wxWidgets开发环境
---
## 1. 关于wxWidgets
    wxWidgets是一个开源的跨平台的C++构架库， ， ，
    wxWidgets的开源遵循L-GPL协议， ， ， ，
    截至本文档最后一次更新，
## 2. 关于Code::Blocks
    Code::Blocks是一个开放源码的全功能的跨平台集成开发环境。主要针对C/C++语言的开发而设计， ， ， ， ，
    CodeBlocks的开源遵循GPLv3协议， ，
    截至本文档最后一次更新，
## 3. 基于GCC和Code::Blocks的SDK环境搭建
#### 2.1. 下载Code::Blocks
    请访问[Code::Blocks下载页面](http://www.codeblocks.org/downloads)下载Code::Blocks集成开发环境的最新发布版本。
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/01.png' title = 'Codeblocks下载页面' style = 'max-width:800px' > < / img > < / p >
>
>< p align = 'center' > < img src = 'images/A1/02.png' title = 'Codeblocks下载链接' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    在Code::Blocks的下载页面中有很多版本可供选择， ， ， ， ， ， ， ，
    CodeBlocks可以适配多种编译器， ， ， ，
    为了方便， ， ， （ ） ，
>- **关于IDE和编译器路径：
>从Windows Vista开始， ， ， ，
>包含中文字符、空格或其他字符的路径可能会导致CodeBlocks中配置号编译器以后， ，
>- **操作系统、应用程序和编译器的位模式**
2020-12-24 14:43:15 +00:00
>从20.03版本开始， ， ， ， ， ， ， ，
2020-05-17 10:45:16 +00:00
>如果下载的是带有编译器的CodeBlocks， ，
#### 2.2. 部署wxWidgets
    请访问[wxWidgets下载页面](http://www.wxwidgets.org/downloads/)下载wxWidgets库文件。本例使用最新的稳定版wxWidgets库进行配置， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/03.png' title = 'wxWidgets下载页面' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
>
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/04.png' title = 'wxWidgets稳定版发布链接' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    选择wxWidgets的“Download windows binaries”链接后， ， ， ， ， ， ， ， ， ， （ ） ， ， ， ； ，
    由于我们是出于开发目的， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/05.png' title = 'wxWidgets下载列表' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
   下载后， ， ， ， ，
    部署后的目录结构应为：
```
wxWidgets库目录
├─ include
│ ├─ msvc
│ │ └─ wx
│ │ └─ setup.h
│ └─ wx
│ ├─ [DIR ](子文件夹 )
│ └─ *.h（ ）
└─ lib
2020-09-18 15:40:56 +00:00
└─ gcc_dll(这个文件夹的名字依据个人使用习惯可能有所不同，
2020-05-17 10:45:16 +00:00
├─ mswu
├─ mswud
└─ *.a(库文件)
```
#### 2.3. 配置Code::Blocks下的wxWidgets开发环境
    启动Code::Blocks， （ ） （ ）
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/06.png' title = 'Global variables菜单' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    在打开的全局变量编辑窗口中， ， ， ， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/07.png' title = '新建全局变量' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
   然后将全局变量的根路径、包含路径和库路经分别设置为wxWidgets的根路径include路径和lib路径， ，
>全局变量配置
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/08.png' title = '全局变量配置' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
>
>- 关于CodeBlocks中wxWidgets库全局变量的配置与使用：
>事实上， ， ， ，
#### 2.4. 配置编译器与调试器
    在Code::Blocks的“Settings”（ ） （ ） ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/09.png' title = '调试器配置菜单' style = 'max-width:800px' > < / img > < / p >
>- 由于在编译器的配置过程中需要设定对应的调试器，为避免反复操作，所以这里优先进行调试器的设置。
2020-05-17 10:45:16 +00:00
    在调试器设置页面右侧的树形列表中， ， （ ） ， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/10.png' title = '新建调试器配置' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    然后点击选中右侧树形工具栏中新建的调试器项目， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/11.png' title = '修改调试器配置' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    完成配置后， ， ， （ ） （ ） ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/12.png' title = '编译器配置菜单' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    选择编译器配置页面中的“Toolchain executable”（ ） ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/13.png' title = '编译工具链设置' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    在此页面中， ， ，
    接下来需要确认所选编译器的各项配置， ， ，
>- 关于CodeBlocks编译器的路径
>在CodeBlocks的编译器设置中， ， ， ， ， ，
    其他的项目如果没有其他特殊需求， ， ， ，
>- 编译器与调试器配置
2020-05-27 14:57:52 +00:00
>由于在调试模式下、调试程序需要的Debug信息会在编译时写入目标文件， ， ， ，
2020-05-17 10:45:16 +00:00
    完成上述配置后关闭环境变量编辑窗口， ，
## 3. 建立一个简单的工程
#### 3.1. 启动CodeBlocks工程向导
    依次选择菜单栏中“File”、“New”、“Project”菜单，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/14.png' title = '新建工程菜单' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    选择向导列表中的“wxWidgets Project”， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/15.png' title = '选择工程向导' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
#### 3.2. 创建wxWidgets工程
    第一个面中是wxWidgets工程向导的一些介绍信息，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/16.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    接下来选择使用的wxWidgets库的版本。
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/17.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    本示例中部署的为wxWidgets的3.0.5版本， ，
    然后是命名新工程并选择创建工程的路径。
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/18.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    这里根据自己的使用习惯， ，
    接下来的页面中，可以录入一些自己的版权信息，包括作者名、电子邮件和个人主页，这些信息将会反映在即将创建的新工程中。
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/19.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
>
2020-05-17 10:45:16 +00:00
    填写完成后点击“Next继续”，
    下一个页面中设定的是设计器类型（ ）
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/20.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    设计器就是用于构建GUI界面的可视化设计工具， （ ） ， ， ， ， ，
>- wxWIdgets的设计器：
>CodeBlocks的工程向导中， ， ， ， ， ， ， ， ， ， ， ， ， ， ， ， ， ， ，
    应用类型的选择， ， （ ） （ ） ， ，
    全部选择完成后，
    接下来的页面中， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/21.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
>
2020-05-17 10:45:16 +00:00
    这里就需要用到前文创建的wxWidgets库名字了， ， ， ， ， ， ， ， ，
>- 关于CodeBlocks的全局变量
>CodeBlocks的全局变量是一个极具特色的功能， ，
>以本例为例， ， ， ， ， ， ，
>当然，环境变量的引用不仅仅限于编译过程，同样会被用于其他地方，例如代码提醒与自动补全的解析等。
    接下来的页面中，是对编译器的选择和编译中间文件和目标文件输出路径的选择。
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/22.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    比较重要的是对编译器的选择， ，
    选择完成后，
    接下来需要选择的是将要使用的wxWidgets库的一些特性，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/23.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
2021-02-19 08:34:09 +00:00
    比较重要的是“wxWidgets Library Setting”中的三个选项。第一个选项“Use wxWidgets DLL”决定使用的是wxWidgets的动态库还是静态库， ， ， ， ， ， ， ， ， ， ， ， ， ， ， ，
    选择完成后，
2020-05-17 10:45:16 +00:00
    下一项需要选择的是需要包含的功能库。
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/24.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
2021-02-19 08:34:09 +00:00
    如果上一步的设定中没有勾选“wxWidgets is built as a monolithic library”设定项， ， ， ， ，
2020-05-17 10:45:16 +00:00
    选择完成后，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/25.png' title = 'wxWidgets工程创建' style = 'max-width:800px' > < / img > < / p >
>
2020-05-17 10:45:16 +00:00
    然后点击工具栏上的编译按钮， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/25.png' title = '编译' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    编译完成后， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/25.png' title = '运行范例工程' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
    至此wxWidgets的开发环境搭建并校验完成。
## 4. 常见错误
2020-06-03 16:11:38 +00:00
#### 4.1. 编译错误：
2020-05-17 10:45:16 +00:00
    **原因：**这个错误是libwxmsw30ud.a库文件找不到所致， ， ， ，
    **解决方式：**解决这个错误有两个方法， ， ， ， ， ，
2020-06-03 16:11:38 +00:00
#### 4.2. 编译错误：
2020-05-17 10:45:16 +00:00
2020-06-03 16:11:38 +00:00
    此错误多出现在wxWidgets的platform.h头文件中，
    这个错误多见于没有使用CodeBlocks的wxWidgets工程向导生成的工程中， ， ， ， ， ， ， ， ， ， ， （ ） ， ， ， ， ， ， ， ， ， ， ， ， ，
2020-05-17 10:45:16 +00:00
    所以， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/QA01.png' title = '编译选项菜单' style = 'max-width:800px' > < / img > < / p >
2020-05-17 10:45:16 +00:00
然后分别检查所有编译目标下“Search directories”下的“Compiler”标签中定义的包含路径， ， ，
2020-05-17 11:38:12 +00:00
>< p align = 'center' > < img src = 'images/A1/QA02.png' title = '修改包含路径' style = 'max-width:800px' > < / img > < / p >
2022-11-30 15:58:20 +00:00
    修改好包含路径， ，
2020-05-17 10:45:16 +00:00
>- 关于多版本wxWidgets库之间的切换
>如果确实需要多版本wxWidgets库之间进行切换， ， ， ， ， ，
>在Windows下创建软链接的命令为“mklink /J”， ，
2022-11-30 15:58:20 +00:00
#### 4.3. 编译错误：无效的工具链配置
    这个错误是因为编译器配置错误导致的无法开始编译，通常出现在编译一个已经存在的工程，这个工程可能是在别的电脑上建立的或者从网络上下载的。
    作为一个通用型IDE， ， ， ， ，
>< p align = 'center' > < img src = 'images/A1/QA03.png' title = '工具链配置错误导致的无法开始编译' style = 'max-width:800px' > < / img > < / p >
    其实这个错误的解决方法已经写在提示中了，
>< p align = 'center' > < img src = 'images/A1/QA04.png' title = '设置工程使用的编译工具配置' style = 'max-width:800px' > < / img > < / p >
    选择设置好的的编译器配置， ，
#### 4.4. 编译错误：找不到链接的库文件
    这个错误和4.2是类似的原因，
>< p align = 'center' > < img src = 'images/A1/QA05.png' title = 'wxWidgets的库文件找不到' style = 'max-width:800px' > < / img > < / p >
    解决方式也和4.2类似，
>< p align = 'center' > < img src = 'images/A1/QA06.png' title = '设置正确的库文件路径' style = 'max-width:800px' > < / img > < / p >
    修改好库文件的搜索路径， ，
2020-05-17 10:45:16 +00:00
### 5. 联系开发者
2021-02-19 08:34:09 +00:00
    首先，
2020-05-17 10:45:16 +00:00
    虽然最早仅仅作为一套GUI接口库使用， ， ， ， & k=5ahGPvK)留言交流。
>SimpleGUI@开源中国：
>SimpleGUI@码云：
    本人并不是全职的开源开发者，依然有工作及家庭的琐碎事务要处理，所以对于大家的需求和疑问反馈的可能并不及时，多有怠慢，敬请谅解。
    最后，再次感谢您的支持。
