Skip to main content
Version: v3

HeatProject Task

The HeatProject task wraps heat.exe, the WiX harvester, using the project harvesting type. 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 HeatProject task:

<span style="color: blue">&lt;</span><span style="color: #a31515">HeatProject
</span><span style="color: red">NoLogo</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsNoLogo)</span>&quot;
<span style="color: red">SuppressAllWarnings</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsSuppressAllWarnings)</span>&quot;
<span style="color: red">SuppressSpecificWarnings</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsSuppressSpecificWarnings)</span>&quot;
<span style="color: red">ToolPath</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(WixToolPath)</span>&quot;
<span style="color: red">TreatWarningsAsErrors</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsTreatWarningsAsErrors)</span>&quot;
<span style="color: red">TreatSpecificWarningsAsErrors</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsTreatSpecificWarningsAsErrors)</span>&quot;
<span style="color: red">VerboseOutput</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsVerboseOutput)</span>&quot;
<span style="color: red">AutogenerateGuids</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsAutogenerateGuids)</span>&quot;
<span style="color: red">GenerateGuidsNow</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsGenerateGuidsNow)</span>&quot;
<span style="color: red">OutputFile</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(IntermediateOutputPath)_%(_Project.Filename).wxs</span>&quot;
<span style="color: red">SuppressFragments</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsSuppressFragments)</span>&quot;
<span style="color: red">SuppressUniqueIds</span><span style="color: blue">=</span>&quot;<span style="color: blue">$(HarvestProjectsSuppressUniqueIds)</span>&quot;
<span style="color: red">Transforms</span><span style="color: blue">=</span>&quot;<span style="color: blue">%(_Project.Transforms)</span>&quot;
<span style="color: red">Project</span><span style="color: blue">=</span>&quot;<span style="color: blue">@(_Project)</span>&quot;
<span style="color: red">ProjectOutputGroups</span><span style="color: blue">=</span>&quot;<span style="color: blue">%(_Project.ProjectOutputGroups)</span>&quot; <span style="color: blue">/&gt;</span>

The following table describes the common WiX MSBuild parameters that are applicable to the HeatProject task.

ParameterDescription
NoLogoOptional boolean parameter.

Specifies that the tool logo should be suppressed. The default is false. This is equivalent to the -nologo switch.
SuppressAllWarningsOptional boolean parameter.

Specifies that all warnings should be suppressed. The default is false. This is equivalent to the -sw switch.
SuppressSpecificWarningsOptional string parameter.

Specifies that certain warnings should be suppressed. This is equivalent to the -sw[N] switch.
TreatSpecificWarningsAsErrorsOptional string parameter.

Specifies that certain warnings should be treated as errors. This is equivalent to the -wx[N] switch.
TreatWarningsAsErrorsOptional boolean parameter.

Specifies that all warnings should be treated as errors. The default is false. This is equivalent to the -wx switch.
VerboseOutputOptional boolean parameter.

Specifies that the tool should provide verbose output. The default is false. This is equivalent to the -v switch.

The following table describes the parameters that are common to all heat tasks that are applicable to the HeatProject task.

ParameterDescription
AutogenerateGuidsOptional boolean parameter.

Whether to generate authoring that relies on auto-generation of component GUIDs. The default is $(HarvestAutogenerateGuids) if specified; otherwise, true.
GenerateGuidsNowOptional boolean parameter.

Whether to generate authoring that generates durable GUIDs when harvesting. The default is $(HarvestGenerateGuidsNow) if specified; otherwise, false.
OutputFileRequired item parameter.

Specifies the output file that contains the generated authoring.
SuppressFragmentsOptional boolean parameter.

Whether to suppress generation of separate fragments when harvesting. The default is $(HarvestSuppressFragments) if specified; otherwise, true.
SuppressUniqueIdsOptional boolean parameter.

Whether to suppress generation of unique component IDs. The default is $(HarvestSuppressUniqueIds) if specified; otherwise, false.
TransformsOptional string parameter.

XSL transforms to apply to all generated WiX authoring. Separate multiple transforms with semicolons. The default is $(HarvestTransforms) if specified.

The following table describes the parameters that are specific to the HeatProject task.

ParameterDescription
ProjectRequired item group parameter.

The list of projects to harvest.
ProjectOutputGroupsOptional string parameter.

The project output groups to harvest. Separate multiple output groups with semicolons. Examples include "Binaries" and "Source".