wireshark/packaging/wix
Gerald Combs 364d9a999d Look in %VCToolsRedistDir% for the VC++ redistributable.
Look in %VCToolsRedistDir% for the redistributable that we ship with
the NSIS installer. Clarify a couple of status messages.

Change-Id: I965d15947c3d3422d7c722afa581f4f7dfc2725a
Reviewed-on: https://code.wireshark.org/review/25804
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2018-02-15 17:10:37 +00:00
..
CMakeLists.txt Look in %VCToolsRedistDir% for the VC++ redistributable. 2018-02-15 17:10:37 +00:00
COPYING.rtf
ComponentGroups.wxi Fix (and chop) static build option 2017-11-19 20:16:50 +00:00
DirectoryStructure.wxi Refactor plugin registration and loading 2017-12-14 08:43:57 +00:00
Features.wxi Add dftest to Windows installer. 2017-06-23 14:24:31 +00:00
InputPaths.wxi WiX: Switch to Visual Studio 2015. 2017-06-07 19:45:37 +00:00
Makefile.am autotools: make maintainer-clean should allow rerunning 'configure' 2017-10-15 14:17:20 +00:00
Plugins.wxi Make the DOCSIS dissector a built-in dissector. 2018-02-13 20:15:19 +00:00
Prerequisites.wxi CMake: Set the Windows build target to Vista. 2017-10-26 17:57:28 +00:00
README WiX: Fixup merge module configuration. 2017-06-17 19:32:37 +00:00
StringOverrides.wxl WiX: Add a warning and increase compression. 2016-09-11 04:35:20 +00:00
UserInterface.wxi
Wireshark.wxs WiX: Try to fix development upgrades. 2016-09-26 23:22:49 +00:00
WiresharkOptionsDlg.wxs Add lcap file extension to nsis and wix installers. 2017-09-23 20:15:11 +00:00
WiresharkWixUI.wxs
banner.bmp Remove executable bit, from not executable files. 2017-02-26 17:49:34 +00:00
banner.svg
dialog.bmp Remove executable bit, from not executable files. 2017-02-26 17:49:34 +00:00
dialog.svg
windeployqt-to-wix.ps1 replace SPDX identifier GPL-2.0+ with GPL-2.0-or-later. 2018-02-08 14:57:36 +00:00

README

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. 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 and VS 2015 / CRT140 are supported.
3. 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.