Lit Task
The Lit task wraps lit.exe, the WiX library creation tool. It supports a variety of settings that are described in more detail below. To control these settings in your .wixproj file, you can create a PropertyGroup and specify the settings that you want to use for your build process. The following is a sample PropertyGroup that contains settings that will be used by the Lit task:
<PropertyGroup> <LibTreatWarningsAsErrors>False</LibTreatWarningsAsErrors> <LibVerboseOutput>True</LibVerboseOutput> <SuppressSpecificWarnings>1111</SuppressSpecificWarnings> <TreatSpecificWarningsAsErrors>2222</TreatSpecificWarningsAsErrors> </PropertyGroup>
The following table describes the common WiX MSBuild parameters that are applicable to the Lit task.
Parameter | Description |
BindInputPaths | Optional string parameter. Specifies a binder path that should be used to locate all files. This is equivalent to the -b <path> switch. Named BindPaths are created by prefixing the 2-or-more-character bucket name followed by an equal sign ("=") to the supplied path. |
BindFiles | Optional boolean parameter. Specifies that the tool should bind files into a .wixout file. This is only valid when the OutputAsXml parameter is also provided. This is equivalent to the -bf switch. |
Pedantic | Optional boolean parameter. Specifies that the tool should display pedantic messages. This is equivalent to the -pedantic switch. |
SuppressAllWarnings | Optional boolean parameter. Specifies that all warnings should be suppressed. This is equivalent to the -sw switch. |
SuppressIntermediateFileVersionMatching | Optional boolean parameter. Specifies that the tool should suppress intermediate file version mismatch checking. This is equivalent to the -sv switch. |
SuppressSchemaValidation | Optional boolean parameter. Specifies that schema validation of documents should be suppressed. This is equivalent to the -ss switch. |
SuppressSpecificWarnings | Optional string parameter. Specifies that certain warnings should be suppressed. This is equivalent to the -sw[N] switch. |
TreatSpecificWarningsAsErrors | Optional string parameter. Specifies that certain warnings should be treated as errors. This is equivalent to the -wx[N] switch. |
TreatWarningsAsErrors | Optional boolean parameter. Specifies that all warnings should be treated as errors. This is equivalent to the -wx switch. |
VerboseOutput | Optional boolean parameter. Specifies that the tool should provide verbose output. This is equivalent to the -v switch. |
The following table describes the parameters that are specific to the Lit task.
Parameter | Description |
LibAdditionalOptions | Optional string parameter. Specifies additional command line parameters to append when calling lit.exe. |
LibBindFiles | Optional boolean parameter. Specifies that the library creation tool should bind files into a .wixout file. This is only valid when the OutputAsXml parameter is also provided. This is equivalent to the -bf switch in lit.exe. |
LibPedantic | Optional boolean parameter. Specifies that the library creation tool should display pedantic messages. This is equivalent to the -pedantic switch in lit.exe. |
LibSuppressAllWarnings | Optional boolean parameter. Specifies that all library creation tool warnings should be suppressed. This is equivalent to the -sw switch in lit.exe. |
LibSuppressIntermediateFileVersionMatching | Optional boolean parameter. Specifies that the library creation tool should suppress intermediate file version mismatch checking. This is equivalent to the -sv switch in lit.exe. |
LibSuppressSchemaValidation | Optional boolean parameter. Specifies that the library creation tool should suppress schema validation of documents. This is equivalent to the -ss switch in lit.exe. |
LibSuppressSpecificWarnings | Optional string parameter. Specifies that certain library creation tool warnings should be suppressed. This is equivalent to the -sw[N] switch in lit.exe. |
LibTreatSpecificWarningsAsErrors | Optional string parameter. Specifies that certain library creation tool warnings should be treated as errors. This is equivalent to the -wx[N] switch in lit.exe. |
LibTreatWarningsAsErrors | Optional boolean parameter. Specifies that all library creation tool warnings should be treated as errors. This is equivalent to the -wx switch in lit.exe. |
LibVerboseOutput | Optional boolean parameter. Specifies that the library creation tool should provide verbose output. This is equivalent to the -v switch in lit.exe. |
LinkerBindInputPaths | Optional string parameter. Specifies a binder path that the library creation tool should use to locate all files. This is equivalent to the -b <path> switch in lit.exe. Named BindPaths are created by prefixing the 2-or-more-character bucket name followed by an equal sign ("=") to the supplied path. |