wireshark2.6.x在windows下成功编译

这是我在简书上的文章，转过来，希望更多遇到这个问题的人看到。

1、背景

在linux下调试代码确实不方便，gdb命令毕竟用的没可视化界面舒服，所以想编译下wireshark，网上的资料很少，主要是以下两篇文章，本文也是结合官方文档和这两篇文章的总结，希望对大家有所帮助。

参考主要的文章：
https://blog.csdn.net/dreamnow1201/article/details/80200785?tdsourcetag=s_pctim_aiomsg
https://blog.csdn.net/dreamnow1201/article/details/80087174

2、准备

2.1 需要安装软件

需要安装的软件有：

• Visual Studio 和SDK
• QT5
• 可选安装cygwin
• python 2.x或3.x
• git
• cmake c的构建工具类似于maven
• Chocolatey 推荐安装这个windows下的yum 通过命令方式安装软件。

2.2 Visual Studio

1、c编译器可以下载 vs2015的社区版，下载地址为：https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x409
说明：visual stdio 好多版本都行，最好是在2010以上
下载后，其实只是在线安装工具，这坑货需要安装空间竟然达到12G，需要预留很大的空间。
选择“自定义”安装，选择“Visual C++2015 常用工具”，其他的都取消。
如果用命令安装，则通过下面命令安装：

PS $> choco install -y VisualStudio2015Community --timeout 0 -package-parameters“--AdminFile path \ to \ msvc2015AdminDeployment.xml”

2.3 安装Qt

wireshark的界面是使用Qt的窗口工具包，要安装qt，则通过：
请从Qt项目“下载开源”页面下载Qt Online Installer for Windows，并选择与目标系统和编译器匹配的组件。例如，“ msvc2015 64位 ”组件用于构建官方64位软件包。您可以取消选择所有Qt xxxx（例如Qt Charts）组件，因为它们不是必需的。

2.4 可选安装cygwin

虽然说是可选的，但是还是建议安装，不然不知道有什么问题，我是安装的
cygwin可以选择x86或64位版本，选择软件：

• Devel/bison (or install Win flex-bison — see Chocolatey above)
• Devel/flex (or install Win flex-bison — see Chocolatey above)
• Devel/git (recommended, but it’s also available via Chocolatey — see the Git discussion below)
• Interpreters/perl
• Utils/patch (only if needed) (may be Devel/patch instead)
• Text/docbook-xml45 (only needed if you’re building the documenation)
• Interpreters/m4
  也可以通过命令行安装：

PS$>choco install -y cygwin
PS$>choco install -y cyg-get

默认安装在c:\tools\cygwin
需要安装包的时候可以通过下面命令安装

PS$>cyg-get docbook-xml45 [...]

2.5 安装python

2.x或3.x版本都行，普通安装没什么特殊的，也可以通过命令安装

PS$>choco install -y python3
or

PS$>choco install -y python2

2.6 安装CMake

按照提示安装即可。

2.7 忽视安装git和TortoiseGit

非必须忽视

2.8 可选安装Asciidoctor，Xsltproc和DocBook

Asciidoctor可以直接作为Ruby脚本运行，也可以通过Java包装器（AsciidoctorJ）运行。它与Xsltproc和DocBook结合使用，以生成您正在阅读的文档和用户指南。

在Windows上安装它们的最简单方法是通过Chocolatey：

PS $> choco install -y asciidoctorj xsltproc docbook-bundle

Chocolatey确保asciidoctorj.exe和xsltproc.exe在您的路径上，并且xsltproc使用DocBook目录。

3、环境变量配置

WIRESHARK_BASE_DIR = wireshark的目录
WIRESHARK_LIB_DIR = wireshark-win64-libs-2.6
注意：编译过程中下载库的目录，必须是wireshark-*-libs*这种格式
QT5_BASE_DIR =D:\Qt\Qt5.11.2\5.11.2\msvc2015_64
注意：Qt安装目录注意一定要指向这个位置，不是主目录

WIRESHARK_VERSION_EXTRA = -YourExtraVersionInfo
附加在wireshark之后的版本信息。
WIRESHARK_CYGWIN_INSTALL_PATH = C：\ ProgramData \ chocolatey \ lib \ Cygwin \ tools \ cygwin
如果CMake未自动检测到您的Cygwin安装路径，则可以使用以下环境变量显式指定它。
如果你的VS版本地域2012则需要配置环境变量：
VisualStudioVersion = 10.0

4、构建工程

1）新建目录作为构建目录，构建生成的vs工程文件都在这个目录下，比如wiresharkprj。
2）打开开始菜单中Visual Studio 2015目录中VS2015 x64 Native Tools Command Prompt，切换到上面创建的构建目录。
3）执行命令：
注意：wireshark 为wireshark的源码所在的目录。

> cmake -DENABLE_CHM_GUIDES=on -G "Visual Studio 14 2015 Win64" ..\wireshark

在CMake生成过程结束时，应显示以下内容：

• 配置完成
• 生成完成
• 构建文件已写入：C：/ Development / wsbuild32
  如果您获得任何其他输出，则您的环境中存在必须在构建之前纠正的问题。检查传递给C进行参数，特别是-G选项和路径Wireshark的源和环境变量WIRESHARK_BASE_DIR和QT5_BASE_DIR。

4）构建wireshark

 msbuild /m /p:Configuration=RelWithDebInfo Wireshark.sln

构建过程会生成大量信息，完成后在构建目录下的run\RelWithDebInfo\Wireshark.exe
打开帮助 → 关于。如果它显示您的“私人”程序版本，
例如：版本2.9.0-myprotocol123恭喜！你已经编译了自己的Wireshark版本！
如果编译出错，可以通过下面命令清理：

msbuild /m /p:Configuration=RelWithDebInfo Wireshark.sln /t:Clean

如果你需要构建安装的版本需要参考：
官网这里2.2.15

5、遇到问题

除了自己改的代码问题，遇到的问题有：
1）环境变量设置错误：
QT5_BASE_DIR =D:\Qt\Qt5.11.2\5.11.2\msvc2015_64
原来设置到的是Qt的主目录导致报错。

2）编译下载库的目录名起错了。
WIRESHARK_LIB_DIR这个构建目录我随便起个名字，结果不对，编译过程的下载目录必须是
wireshark-*-libs* 这种格式。

其他的还蛮顺利的。
祝你也顺利。

6、调试

你如果和我的目的一样，需要调试wireshark的代码，打开vs后，先运行tshark，然后通过attach命令进行关联运行的程序，在下面设置断点，这里面只能设置到函数名。

有点失望，我希望是直接可以在vs里面进行编译运行，然而好像不行。