diff options
| author | Michael Mann <mmann78@netscape.net> | 2016-04-07 19:03:51 -0400 |
|---|---|---|
| committer | Michael Mann <mmann78@netscape.net> | 2016-05-11 13:09:17 +0000 |
| commit | c34996f970ab003bb8566825b38834de00f5159e (patch) | |
| tree | fda0c581d87baf3cb0264affaaeb861354f66311 /packaging/wix/README | |
| parent | 980f58bc277df178a15b4c730fb1b0cbd462da0b (diff) | |
Create a Wix Installer
This is intended to replace the NSIS installer for Windows.
It does not include installing WinPcap or USBPcap. From the research I've done, it seems to make more sense to "bundle" them with Wix ("wrapper" installer that would include Wireshark, WinPcap and USBPcap installers together)
TODO:
1. Customize installer with Wireshark graphics
2. Better handling flexibility of installing VC CRT Merge module (need build script to provide appropriate macros). Something like (or modifying existing) FindMSVC_REDIST.cmake.
3. Use Wireshark UpgradeProductCode for install/uninstall. Previous NSIS installer did not have an upgrade code, so there are some backwards compatibility concerns.
4. Uninstall considerations (removing whole directories - plugins, configuration profiles?). NSIS needed to do more things "manually" than Wix does by default. Need to merge as best as possible to handle backwards compatibility.
Many thanks to Brian Pratt for all the Wix help.
Change-Id: Ib50780214fc7707ba2a46fd96ba8797a1763fa0c
Reviewed-on: https://code.wireshark.org/review/14858
Reviewed-by: Michael Mann <mmann78@netscape.net>
Diffstat (limited to 'packaging/wix/README')
| -rw-r--r-- | packaging/wix/README | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/packaging/wix/README b/packaging/wix/README new file mode 100644 index 0000000000..57ae2fefc8 --- /dev/null +++ b/packaging/wix/README @@ -0,0 +1,36 @@ +WiX installer for Wireshark + +This is currently an experimental feature to provide Wireshark with an .msi installer. +It is intended to replace the NSIS installer, but needs to be a little more complete +before doing so. + +(Developer) Differences/notes compared to NSIS installer: +1. You need the WiX toolset to build the installer. See http://wixtoolset.org/releases/ +(v3.10 is recommended) +2. SNMP, Radius, Diameter, and Qt translations files are harvested to be included in +the installer. Any custom/additional files just need to be written to the appropriate +build output directory and the installer will pick them up. NSIS required modifying +a file (custom_mibs.txt, etc) for inclusion +3. Plugin DLLs are not automatically harvested. To include your DLL, modify Plugins.wxi +4. To build the WiX installer run: +> msbuild /m /p:Configuration=RelWithDebInfo wix_package_prep.vcxproj +> msbuild /m /p:Configuration=RelWithDebInfo wix_package.vcxproj + + +Known issues: +1. It does not include installing WinPcap or USBPcap (the NSIS installer does). These +currently come as NSIS installers and it seems it would make more sense to "bundle" them +with WiX rather than include them as part of the Wireshark.msi. +2. Installer needs to be customized to include Wireshark graphics. +3. Needs more flexible handling of VC CRT Merge module (need build script to provide +appropriate macros). Something like (or modifying existing) FindMSVC_REDIST.cmake. +Currently only VS2013 CRT120 is supported. +4. Uninstalling previous versions. NSIS installer did things more "manually" than Wix does +by default. Need to merge as best as possible to handle backwards compatibility. The .msi +architecture uses an "UpgradeCode" help facilitate install/uninstall/upgrade and NSIS +installer doesn't have that. The NSIS installer also removed whole directories instead of +just removing what it installed (still not sure if this is better or worse) + + +Patches welcome to address any of the issues above or improvements you think can be +made. |