// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
namespace WixToolset.HeatTasks
{
using System;
using System.IO;
using System.Runtime.InteropServices;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
///
/// A base MSBuild task to run the WiX harvester.
/// Specific harvester tasks should extend this class.
///
public abstract partial class HeatTask : ToolTask
{
private static readonly string ThisDllPath = new Uri(typeof(HeatTask).Assembly.CodeBase).AbsolutePath;
///
/// Gets or sets additional options that are appended the the tool command-line.
///
///
/// This allows the task to support extended options in the tool which are not
/// explicitly implemented as properties on the task.
///
public string AdditionalOptions { get; set; }
///
/// Gets or sets whether to display the logo.
///
public bool NoLogo { get; set; }
///
/// Gets or sets whether all warnings should be suppressed.
///
public bool SuppressAllWarnings { get; set; }
///
/// Gets or sets a list of specific warnings to be suppressed.
///
public string[] SuppressSpecificWarnings { get; set; }
///
/// Gets or sets whether all warnings should be treated as errors.
///
public bool TreatWarningsAsErrors { get; set; }
///
/// Gets or sets a list of specific warnings to treat as errors.
///
public string[] TreatSpecificWarningsAsErrors { get; set; }
///
/// Gets or sets whether to display verbose output.
///
public bool VerboseOutput { get; set; }
public bool AutogenerateGuids { get; set; }
public bool GenerateGuidsNow { get; set; }
[Required]
[Output]
public ITaskItem OutputFile { get; set; }
public bool SuppressFragments { get; set; }
public bool SuppressUniqueIds { get; set; }
public string[] Transforms { get; set; }
protected sealed override string ToolName => "heat.exe";
///
/// Gets the name of the heat operation performed by the task.
///
/// This is the first parameter passed on the heat.exe command-line.
/// The name of the heat operation performed by the task.
protected abstract string OperationName { get; }
private string ToolFullPath
{
get
{
if (String.IsNullOrEmpty(this.ToolPath))
{
return Path.Combine(Path.GetDirectoryName(ThisDllPath), this.ToolExe);
}
return Path.Combine(this.ToolPath, this.ToolExe);
}
}
///
/// Get the path to the executable.
///
///
/// ToolTask only calls GenerateFullPathToTool when the ToolPath property is not set.
/// WiX never sets the ToolPath property, but the user can through $(HeatToolDir).
/// If we return only a file name, ToolTask will search the system paths for it.
///
protected sealed override string GenerateFullPathToTool()
{
#if NETCOREAPP
// If we're not using heat.exe, use dotnet.exe to exec heat.dll.
// See this.GenerateCommandLine() where "exec heat.dll" is added.
if (!IsSelfExecutable(this.ToolFullPath, out var toolFullPath))
{
return DotnetFullPath;
}
return toolFullPath;
#else
return this.ToolFullPath;
#endif
}
protected sealed override string GenerateCommandLineCommands()
{
var commandLineBuilder = new WixCommandLineBuilder();
#if NETCOREAPP
// If we're using dotnet.exe as the target executable, see this.GenerateFullPathToTool(),
// then add "exec heat.dll" to the beginning of the command-line.
if (!IsSelfExecutable(this.ToolFullPath, out var toolFullPath))
{
//commandLineBuilder.AppendSwitchIfNotNull("exec ", toolFullPath);
commandLineBuilder.AppendSwitch($"exec \"{toolFullPath}\"");
}
#endif
this.BuildCommandLine(commandLineBuilder);
return commandLineBuilder.ToString();
}
///
/// Builds a command line from options in this task.
///
protected virtual void BuildCommandLine(WixCommandLineBuilder commandLineBuilder)
{
commandLineBuilder.AppendIfTrue("-nologo", this.NoLogo);
commandLineBuilder.AppendArrayIfNotNull("-sw", this.SuppressSpecificWarnings);
commandLineBuilder.AppendIfTrue("-sw", this.SuppressAllWarnings);
commandLineBuilder.AppendIfTrue("-v", this.VerboseOutput);
commandLineBuilder.AppendArrayIfNotNull("-wx", this.TreatSpecificWarningsAsErrors);
commandLineBuilder.AppendIfTrue("-wx", this.TreatWarningsAsErrors);
commandLineBuilder.AppendIfTrue("-ag", this.AutogenerateGuids);
commandLineBuilder.AppendIfTrue("-gg", this.GenerateGuidsNow);
commandLineBuilder.AppendIfTrue("-sfrag", this.SuppressFragments);
commandLineBuilder.AppendIfTrue("-suid", this.SuppressUniqueIds);
commandLineBuilder.AppendArrayIfNotNull("-t ", this.Transforms);
commandLineBuilder.AppendTextIfNotNull(this.AdditionalOptions);
commandLineBuilder.AppendSwitchIfNotNull("-out ", this.OutputFile);
}
#if NETCOREAPP
private static readonly string DotnetFullPath = Environment.GetEnvironmentVariable("DOTNET_HOST_PATH") ?? "dotnet";
private static bool IsSelfExecutable(string proposedToolFullPath, out string toolFullPath)
{
var toolFullPathWithoutExtension = Path.Combine(Path.GetDirectoryName(proposedToolFullPath), Path.GetFileNameWithoutExtension(proposedToolFullPath));
var exeExtension = RuntimeInformation.IsOSPlatform(OSPlatform.Windows) ? ".exe" : String.Empty;
var exeToolFullPath = $"{toolFullPathWithoutExtension}{exeExtension}";
if (File.Exists(exeToolFullPath))
{
toolFullPath = exeToolFullPath;
return true;
}
toolFullPath = $"{toolFullPathWithoutExtension}.dll";
return false;
}
#endif
}
}