// 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.BaseBuildTasks
{
using System;
using System.Collections.Generic;
using System.IO;
using System.Runtime.InteropServices;
using Microsoft.Build.Utilities;
public abstract class BaseToolsetTask : ToolTask
{
///
/// 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; }
///
/// 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 $(WixToolDir).
/// If we return only a file name, ToolTask will search the system paths for it.
///
protected sealed override string GenerateFullPathToTool()
{
var defaultToolFullPath = this.GetDefaultToolFullPath();
#if NETCOREAPP
// If we're pointing at an executable use that.
if (IsSelfExecutable(defaultToolFullPath, out var finalToolFullPath))
{
return finalToolFullPath;
}
// Otherwise, use "dotnet.exe" to run an assembly dll.
return Environment.GetEnvironmentVariable("DOTNET_HOST_PATH") ?? "dotnet";
#else
return defaultToolFullPath;
#endif
}
///
/// Builds a command line from options in this and derivative tasks.
///
///
/// Derivative classes should call BuildCommandLine() on the base class to ensure that common command line options are added to the command.
///
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.AppendTextIfNotNull(this.AdditionalOptions);
}
protected sealed override string GenerateResponseFileCommands()
{
var commandLineBuilder = new WixCommandLineBuilder();
this.BuildCommandLine(commandLineBuilder);
return commandLineBuilder.ToString();
}
#if NETCOREAPP
protected override string GenerateCommandLineCommands()
{
// If the target tool path is an executable, we don't need to add anything to the command-line.
var toolFullPath = this.GetToolFullPath();
if (IsSelfExecutable(toolFullPath, out var finalToolFullPath))
{
return null;
}
else // we're using "dotnet.exe" to run the assembly so add "exec" plus path to the command-line.
{
return $"exec \"{finalToolFullPath}\"";
}
}
private static bool IsSelfExecutable(string proposedToolFullPath, out string finalToolFullPath)
{
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))
{
finalToolFullPath = exeToolFullPath;
return true;
}
finalToolFullPath = $"{toolFullPathWithoutExtension}.dll";
return false;
}
#else
private string FindArchitectureSpecificToolPath(string baseFolder)
{
var checkedPaths = new List();
// First try to find a folder that matches this task's architecture.
var archFolder = RuntimeInformation.ProcessArchitecture.ToString().ToLowerInvariant();
var path = Path.Combine(baseFolder, archFolder, this.ToolExe);
if (File.Exists(path))
{
return path;
}
checkedPaths.Add(path);
// Try to fallback to "x86" folder since it tends to run on all architectures.
if (!String.Equals(archFolder, "x86", StringComparison.OrdinalIgnoreCase))
{
path = Path.Combine(baseFolder, "x86", this.ToolExe);
if (File.Exists(path))
{
return path;
}
checkedPaths.Add(path);
}
// Return empty, even though this isn't likely to be there.
path = Path.Combine(baseFolder, this.ToolExe);
if (File.Exists(path))
{
return path;
}
checkedPaths.Add(path);
this.Log.LogError("Cannot find tool executable {0} at any of the checked paths: {1}. This is unexpected and will cause later commands to fail.", this.ToolExe, String.Join(", ", checkedPaths));
return path;
}
#endif
private string GetDefaultToolFullPath()
{
#if NETCOREAPP
var thisTaskFolder = Path.GetDirectoryName(typeof(BaseToolsetTask).Assembly.Location);
return Path.Combine(thisTaskFolder, this.ToolExe);
#else
var thisTaskFolder = Path.GetDirectoryName(new Uri(typeof(BaseToolsetTask).Assembly.CodeBase).AbsolutePath);
return this.FindArchitectureSpecificToolPath(thisTaskFolder);
#endif
}
private string GetToolFullPath()
{
if (String.IsNullOrEmpty(this.ToolPath))
{
return this.GetDefaultToolFullPath();
}
return Path.Combine(this.ToolPath, this.ToolExe);
}
}
}