Wireshark Win32/64安裝指南

推薦安裝：chocolatey

Chocolatey是Windows的本機軟件包管理器。它支持Python軟件包索引。
Chocolatey傾向于將軟件包安裝到其自己的路徑（％ChocolateyInstall％）中，盡管軟件包可以自由使用自己的首選項（例如，將Python安裝到C:\Python37）。您可以使用命令choco install（或它的簡寫形式cinst）安裝Chocolatey軟件包，例如：

> rem Flex and Bison are required.
> choco install -y winflexbison3
> rem Git, CMake, Perl, Python, etc are also required, but can be installed
> rem via their respective installation packages.
> choco install -y git cmake strawberryperl python3

安裝Microsoft Visual Studio

下載并安裝“ Microsoft Visual Studio 2019社區版”。

選中“使用C ++進行桌面開發”復選框，然后取消選中“最新工具”，“ Windows 10 SDK”和“用于CMake的Visual C ++工具”中除“ VC ++ 2019”項之外的所有可選組件。

您可以使用Chocolatey，使用Visual Studio社區和本機桌面工作負載包來安裝Visual Studio。

PS$> choco install -y visualstudio2019community visualstudio2019-workload-nativedesktop

您可以使用其他Microsoft C編譯器變體，但是VS2019用于構建開發版本，并且是首選選項。可以使用各種Microsoft C編譯器變體來編譯Wireshark。
不建議使用gcc或Clang進行編譯，Visual Studio的社區版本是免費的，并且包含Visual Studio集成調試器。Visual Studio 2019也被用于創建官方的Wireshark構建，所以它可能會有較少的開發相關問題。

安裝 Qt

Wireshark主應用程序使用Qt窗口工具箱。安裝Qt，請轉到“下載Qt”頁面，選擇“轉到開源”，從Qt項目下載*Qt Online Installer for Windows *，然后為所需的Qt版本選擇與目標系統和編譯器匹配的組件。例如，在撰寫本文時，Qt 5.12.1“ msvc2017 64位”組件用于構建正式的64位軟件包。“ Qt Debug Information Files”組件包含可用于調試的PDB文件。您可以取消選擇不必要的組件，例如“ Qt Charts”或“ Android xxxx”。

請注意，對于32位和64位版本，需要安裝單獨的Qt組件，例如“ msvc2017 32位”和“ msvc2017 64位”。QT5_BASE_DIR應該將環境變量設置為適合您的環境，并指向包含bin目錄的Qt目錄，例如C：\ Qt \ 5.12.5 \ msvc2017_64

Qt維護工具（C：\ Qt \ MaintenanceTool.exe）可用于將Qt升級到較新版本。

安裝Python

從https://python.org/download/獲取Python 3.x安裝程序，并將Python安裝到默認位置（C：\ Python37）。

或者，您可以使用Chocolatey安裝Python：

PS$> choco install -y python3

Chocolatey 默認情況下將Python安裝在C：\ Python37中。

安裝 Perl

從http://strawberryperl.com/或 https://www.activestate.com/獲取Perl安裝程序，然后將Perl安裝到默認位置。

另外，您可以使用Chocolatey安裝Perl：

PS$> choco install -y strawberryperl
# …or…
PS$> choco install -y activeperl

安裝Git

安裝Git源存儲庫會對處理源代碼有幫助，使用Git更新個人源代碼樹（本地存儲庫）要比下載zip文件并將新源代碼手工合并到個人源代碼樹中要容易得多。它還使首次安裝變得容易，并使Wireshark構建過程可以確定您當前的源代碼版本。

有幾種安裝Git的方法。大多數軟件包可從下面的URL或通過Chocolatey獲得。請注意，許多GUI界面取決于命令行版本。

如果要安裝Windows版本的git，請從Windows命令提示符中選擇 Use Git（使用/ GitOnlyOnPath 選項）。千萬不能選擇使用Git和可選的Unix工具從Windows命令提示符選項（在chocolatey/ GitAndUnixToolsOnPath選項）。

Windows官方安裝程序

官方命令行安裝程序可從https://git-scm.com/download/win 獲得。

Git擴展

Git Extensions是Windows的本機Windows圖形Git客戶端。您可以從https://github.com/gitextensions/gitextensions/releases/latest下載安裝程序。

TortoiseGit

TortoiseGit是類似于TortoiseSVN的本地Windows圖形Git。您可以從https://tortoisegit.org/download/下載安裝程序。

通過Chocolatey的命令行客戶端

可以使用Chocolatey安裝（和更新）命令行客戶端：

PS$> choco install -y git

其他

可以在https://git-scm.com/downloads/guis中找到Git的其他GUI界面列表。

安裝CMake

從https://cmake.org/download/獲取CMake安裝程序，并將CMake安裝到默認位置。確保包含cmake.exe的目錄已添加到您的路徑。

您可以使用Chocolatey安裝CMake：

PS$> choco install -y cmake

Chocolatey確保cmake.exe在您的路徑上。

安裝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目錄。

安裝winflexbison

從https://sourceforge.net/projects/winflexbison/獲取winFlexBison安裝程序，并將其安裝到默認位置。確保包含win_flex.exe和win_bison.exe的目錄在您的路徑上。

或者，您可以使用Chocolatey安裝Winflexbison：

PS$> choco install -y winflexbison3

Chocolatey確保win_flex.exe和win_bison.exe在您的路徑上。

安裝和準備sources

下載sources **使用命令行或Git擴展將Wiresharksources *下載到 *C：\ Development \ wireshark：

使用命令行：

>cd C:\Development
>git clone https://code.wireshark.org/review/wireshark

使用Git擴展：

打開Git Extensions應用程序。默認情況下，Git Extensions將在啟動時顯示驗證清單。如果需要修復，請立即修復。您可以隨時通過Tools→ Settings。
在主屏幕中，選擇“ Clone repository”。填寫以下內容：

要克隆的存儲庫： <https://code.wireshark.org/review/wireshark>

目標：您的頂級開發目錄，例如C：\ Development。

要創建的子目錄：您想要的任何內容。通常是wireshark.
單擊Clone按鈕。Git Extensions應該開始克隆Wireshark存儲庫。

打開一個Visual Studio命令提示符

從“開始”菜單（或“開始”屏幕）中，導航到“ Visual Studio 2019”文件夾，然后選擇適合您要生成的構建的命令提示符，例如，“ 64位版本的x64 Native Tools Command Prompt for VS 2019”或“ 32位版本的VS 2019 x86本機工具命令提示符”。根據您的Windows版本，命令提示符列表可能直接位于“ Visual Studio 2019”下，例如:Visual Studio 2019 → Visual Studio Tools → Windows Desktop Command Prompts.
您可以通過運行適當的vcvarsARCHITECTURE.bat命令,可以在自己的命令提示符下設置構建環境。
所有后續操作都在此“命令提示符”窗口中進行。

> rem Let CMake determine the library download directory name under
> rem WIRESHARK_BASE_DIR or set it explicitly by using WIRESHARK_LIB_DIR.
> rem Set one of these.
> set WIRESHARK_BASE_DIR=C:\Development
> rem set WIRESHARK_LIB_DIR=c:\wireshark-win64-libs
> rem Set the Qt installation directory
> set QT5_BASE_DIR=C:\Qt\5.12.5\msvc2017_64
> rem Append a custom string to the package version. Optional.
> set WIRESHARK_VERSION_EXTRA=-YourExtraVersionInfo

設置這些變量可以添加到打開Visual Studio工具命令提示符后要運行的批處理文件中。

創建并更改為正確的構建目錄。CMake最適合在樹外構建配置中使用，在該配置中，構建是在源樹的單獨目錄中進行的，而源樹則保持原始狀態。32位和64位版本需要單獨的版本目錄。創建（如果需要）并轉到適當的構建目錄。

> mkdir C:\Development\wsbuild64
> cd C:\Development\wsbuild64

創建并跳轉到構建目錄。

生成構建文件

CMake用于處理源代碼樹中的CMakeLists.txt文件，并生成適合您系統的構建文件。

您可以生成Visual Studio解決方案文件，以從Visual Studio或MSBuild命令行生成。CMake也可以生成其他構建類型，但不支持它們。

僅在首次創建構建目錄時才需要初始生成步驟。后續構建將根據需要重新生成構建文件。

要生成生成文件，請在Visual Studio命令提示符下輸入以下內容：

cmake -G “Visual Studio 16 2019” -A Win32 ..\wireshark

根據需要調整Python和Wireshark源代碼樹的路徑。要使用其他生成器，請修改-G參數。cmake -G列出了所有CMake支持的生成器，但Wireshark版本僅支持Visual Studio。

要構建x64版本，請將其指定為架構，例如-G "Visual Studio 16 2019" -A x64：

cmake -G“ Visual Studio 16 2019” -A x64 .. \ wireshark

CMake生成過程將根據需要下載所需的第三方庫（Qt除外），然后在生成構建文件之前測試每個庫的可用性。

在CMake生成過程結束時，應顯示以下內容：
– Configuring done
– Generating done
– Build files have been written to: C:/Development/wsbuild64

如果您得到任何其他輸出，則說明環境中的一個問題必須在構建之前解決。檢查傳遞給CMake的參數，尤其是-G選項和Wireshark源以及環境變量WIRESHARK_BASE_DIR和的路徑QT5_BASE_DIR。

建立Wireshark

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

等待Wireshark編譯。這將需要一些時間，并且在命令提示符窗口中將輸出大量文本
運行C：\ Development \ wsbuild64 \ run \ RelWithDebInfo \ Wireshark.exe并確保其啟動。
OpenHelp →About. 如果顯示您的“私有”程序版本，例如：版本3.3.0-myprotocol123，您已編譯了自己的Wireshark版本！

本文章首發在網安wangan.com 網站上。