VS2017 + Win10 下的 OpenCPN 5.0.0 编译过程小结

本文介绍了OpenCPN 5.0.0版本的编译过程，官方网站给出了一个流程，但是亲测后发现还是有一些小坑，官方给出的命令行操作由于网络（可能需要科学上网）不一定畅通，导致难以下载成功，在此把本人成功配置并编译的过程分享出来，让需要的人少走弯路。

目标

基于VS2017(对应VC15)编译最新版OpenCPN的 debug和 realease版本。

参考资料

下载汇总

有些资源下载的很慢，如果实在下载不到，可以用我提供的，源码文件太大超过 440M 只能分成两个资源，每个只要2分，赚个辛苦钱我也好下点资源，谢谢支持。

编译流程

安装VS2017，这一步就不展开了，OpenCPN 官网提到如下要求，注意勾选即可。

Install and select the workload Desktop development with C++ and include component Windows XP support for C++.
Also include the appropriate Windows x SDK component. Generally install the most current version, Windows 10 preferred.

【必须】安装 Git和 CMake, 对应官网都有安装包，找最新的版本下载来安装就好了。
【必须】安装并 POedit, 配置系统环境变量，在PATH中添加

C:\Program Files (x86)\Poedit\GettextTools\bin

【非必须】安装NSIS, OpenCPN提供的网址里的 download 指向错误，在 sourceforge上找到了下载链接，见下载汇总，这个主要用于制作安装包的，如果只是用调试版，暂时用不上这个。
【不重要】安装 7-Zip, 我是把 32 位和 64 位的都安装了，这个主要是解压下载汇总中的预编译依赖压缩包用的，有其他常用的解压工具的话也不是很需要这个。
下载 wxWidgets 3.1.2源码并编译。

【注意】虽然wxWidgets官网提供了 Win下预编译好的库，但是只有 release版本，我们这里直接从源码编译debug和release版本的库，下载官方的最新源码压缩包，这里一定注意，下载这个Zip文件。利用git clone和或下载下面的source code中都没有submodule，虽然利用git的git submodule update命令理论上可以下载到这些子模块，但是亲测由于网络原因几乎无法成功下载，所以还是老实的去上面这里下载。下载Zip完成后，注意有些教程可能说到进入\wxWidgets-3.1.2\build\msw然后找到wx_vc15.sln的工程打开后生成库，我在这里走了弯路，经过测试，这么做会报错，并且不好解决，还是严格按照官网的配置流程来，打开x86 Native Tools Command Prompt for VS 2017后输入如下命令：

cd xx/wxWidgets-3.1.2/build/msw//改到自己的路径
nmake /f makefile.vc BUILD=release SHARED=1 CXXFLAGS=/D_USING_V141_SDK71_ CFLAGS=/D_USING_V141_SDK71_ LDFLAGS=/SUBSYSTEM:WINDOWS,5.01
nmake /f makefile.vc BUILD=debug SHARED=1 CXXFLAGS=/D_USING_V141_SDK71_ CFLAGS=/D_USING_V141_SDK71_ LDFLAGS=/SUBSYSTEM:WINDOWS,5.01

【提示】用Win+S弹出的搜索框中输入x86 Native后就会很容易找到x86 Native Tools Command Prompt for VS 2017。
随着一阵哗哗的输出，release版本的编译完了，按一下回车，继续debug的编译。编译完了后在\wxWidgets-3.1.2\lib\vcdll就能看到debug和release版本的编译好的库。
【重要】编译结束后，设置系统环境变量 wxWIDGETS_ROOT_DIR路径为 wxWidgets源码的顶级目录。

下载 OpenCPN源码, 在你想放置OpenCPN源码的文件夹下，右键选择Git Bash Here, 复制下面的命令后回车就可以直接从github克隆到本地了：

git clone https://github.com/OpenCPN/OpenCPN

下载 预编译Windows依赖 - OpenCPN_buildwin-4.99a.7z，然后解压到\xx\OpenCPN\buildwin也就是复制到你 clone的 OpenCPN源码目录中的 buildwin目录下。
OpenCPN编译之Release版本的编译

首先配置工程，打开x86 Native Tools Command Prompt for VS 2017进入\xx\OpenCPN\路径后输入如下命令：

cd xx\OpenCPN\//还是一样，换成你自己的路径
mkdir build
cd build
cmake -G "Visual Studio 15 2017" -T v141_xp ..

完成后build中就生成了OpenCPN.sln工程文件，官网的编译命令如下：

cmake --build .
cmake --build . --config release
cmake --build . --config release --target package

如果不采用命令行编译，也可以直接打开OpenCPN.sln工程进行编译，因为这里大概率会报错，用VS编译比较方便定位错误，我建议直接打开VS工程编译。打开 \build\OpenCPN.sln工程文件我们来跑一跑OpenCPN看看能不能运行起来。
打开工程后，把opencpn右键设置为启动项目，我这里先选择的是Release(Win32)然后点击运行吧。不出所料，果然出现了一个错误，我们定位到报错行：

xx\OpenCPN\src\options.cpp(8867): error C2001: 常量中有换行符

在这里插入图片描述

看起来是中文字符的问题，查了查资料发现改起来好像比较麻烦，这个字体应该表示繁体中文，我们先把它随便改成英文试一试，例如“正体字”改成“zhengti”(很随意的不要纠结)，继续点击运行，看看还有没有错误没有解决。
刚才字体的问题暂时解决了，但是出现了新的问题：
这个就比较常见了，点击运行的时候提示缺少一些dll，一般是没有加入系统环境变量或者复制到对应的Debug和Release文件夹下，提示缺少一些wx相关的dll，那么大概率就是我们之前的编译好的界面库没有加入系统环境变量，虽然我们之前设置了 wxWIDGETS_ROOT_DIR这一变量，但是我们的dll文件在wxWidgets-3.1.2\lib\vc_dll\路径下，所以我们把这个路径加入系统环境变量PATH中。
仔细检查官网步骤，其实还有一步配置：下载 Copyfiles.bat.doc(见下载汇总)并删去后缀名 .doc移动到\xx\OpenCPN\下面后执行copyfiles.bat（这步不做可能还是会缺几个dll）。
做完上面两步，重启一下VS2017，再打开OpenCPN.sln，直接执行，果然成功了。

OpenCPN编译之Debug版本的编译

将OpenCPN.sln工程中的项目改成Debug(Win32)运行一下，一切都运行正常，那么试一下加断点吧：
也没有出现什么问题，至此Debug和Release版本的OpenCPN都编译并测试完成了。

小结

其实，官网文档已经够用了，我这里大多也只是翻译了一遍，只要严格按照官网提供的步骤，一步一步进行是肯定能够编译成功的。
唯一出现的一点小问题就是最后缺少dll的问题，这个小问题凭借我们一般编译项目的经验就可以解决。
目前遗留的小问题是中文字符的问题，也是个麻烦事，暂时没去解决。
特别需要注意的是，如果对某一模块有指定版本，那么官网都给出了具体的版本号，比如界面库是3.1.2，在不熟练的情况下，第一次编译最好严格按照官网说明的版本进行，可能会少走弯路。
最后我把中间需要用到的安装包和库都放在一起（除了VS2017，Git和CMake），如果实在下不到，可以采用我提供的这些文件，不过，自己试一试走一遍流程，可能印象会更深刻。

VS2017 + Win10 下的 OpenCPN 5.0.0 编译过程小结

目标

参考资料

下载汇总

编译流程

小结

猜你喜欢