MSI Factory

Build

Remove orphaned folders

Whether to temporarily remove any unreferenced folders from the project for the duration of the build. This is to prevent such "orphaned" folders from generating ICE validation errors.

("Orphaned folders" are folders that have been defined on the Folders dialog but are not currently being referenced anywhere in the project.)

Compiler (candle.exe)

Verbose output

Whether to request more detailed output from the WiX compiler. This is the same as passing the -v option to candle.exe.

Additional compiler options:

Allows you to specify additional command line options for candle.exe.

The current candle.exe command line options are:

  -d<name>=<value>  define a parameter for the preprocessor

  -p<file>   preprocess to a file (or stdout if no file supplied)

  -I<dir>    add to include search path

  -nologo    skip printing candle logo information

  -out       specify output file (default: write to current directory)

  -pedantic  show pedantic messages

  -ss        suppress schema validation of documents (performance boost)

  -trace     show source trace for errors, warnings, and verbose messages

  -ext       extension assembly or "class, assembly"

  -zs        only do validation of documents (no output)

  -wx        treat warnings as errors

  -sw<N>     suppress warning with specific message ID

  -v         verbose output

  -?         this help information

To see the latest compiler options, open a command prompt to the WiX folder and type: candle -?

Linker (light.exe)

Verbose output

Whether to request more detailed output from the WiX linker. This is the same as passing the -v option to light.exe.

Additional linker options:

Allows you to specify additional command line options for light.exe.

The current light.exe command line options are:

  -ai        allow identical rows, identical rows will be treated as a warning

  -au        (experimental) allow unresolved references, will not create a valid output

  -b         base path to locate all files (default: current directory)

  -bf        bind files into a wixout (only valid with -xo option)

  -cc        path to cache built cabinets (will not be deleted after linking)

  -ct <N>    number of threads to use when creating cabinets (default: %NUMBER_OF_PROCESSORS%)

  -cultures:<cultures>  semicolon-delimited list of localized string cultures to load from libraries

  -cub       additional .cub file containing ICEs to run

  -d<name>=<value>  define a wix variable

  -ext       extension assembly or "class, assembly"

  -fv        add a 'fileVersion' entry to the MsiAssemblyName table (rarely needed)

  -loc <loc.wxl>  read localization strings from .wxl file

  -nologo    skip printing light logo information

  -notidy    do not delete temporary files (useful for debugging)

  -out       specify output file (default: write to current directory)

  -pedantic  show pedantic messages

  -reusecab  reuse cabinets from cabinet cache

  -sa        suppress assemblies: do not get assembly name information for assemblies

  -sacl      suppress resetting ACLs (useful when laying out image to a network share)

  -sadmin    suppress default admin sequence actions

  -sadv      suppress default adv sequence actions

  -sdut      suppress dropping unreal tables to the output image (default with -xo)

  -sice:<ICE>  suppress an internal consistency evaluator (ICE)

  -sma       suppress processing the data in MsiAssembly table

  -sf        suppress files: do not get any file information (equivalent to -sa and -sh)

  -sh        suppress file info: do not get hash, version, language, etc

  -sl        suppress layout

  -ss        suppress schema validation of documents (performance boost)

  -sui       suppress default UI sequence actions

  -sv        suppress intermediate file version mismatch checking

  -sval      suppress MSI/MSM validation

  -sw<N>     suppress warning with specific message ID

  -ts        tag sectionId attribute on rows (default with -xo)

  -tsa       tag sectionId attribute on rows, generating when null (default with -xo)

  -usf <output.xml>  unreferenced symbols file

  -v         verbose output

  -wx        treat warnings as errors

  -xo        output xml instead of MSI format

  -?         this help information

To see the latest linker options, open a command prompt to the WiX folder and type: light -?

Continue building after validation errors

If checked, the build process will continue (on to the code signing and bootstrapper phases) even if there are validation errors, as long as the actual MSI file was generated successfully.

More Information

WiX Help File: Preprocessor

WiX Help File: Compiler (candle)

WiX Help File: Linker (light)

Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us