// 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.Core.WindowsInstaller.Bind
{
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Globalization;
using System.IO;
using System.Linq;
using WixToolset.Core.Bind;
using WixToolset.Core.WindowsInstaller.Msi;
using WixToolset.Data;
using WixToolset.Data.Tuples;
using WixToolset.Data.WindowsInstaller;
using WixToolset.Extensibility.Services;
///
/// Update file information.
///
internal class UpdateFileFacadesCommand
{
public UpdateFileFacadesCommand(IMessaging messaging, IntermediateSection section)
{
this.Messaging = messaging;
this.Section = section;
}
private IMessaging Messaging { get; }
private IntermediateSection Section { get; }
public IEnumerable FileFacades { private get; set; }
public IEnumerable UpdateFileFacades { private get; set; }
public bool OverwriteHash { private get; set; }
public TableDefinitionCollection TableDefinitions { private get; set; }
public IDictionary VariableCache { private get; set; }
public void Execute()
{
foreach (var file in this.UpdateFileFacades)
{
this.UpdateFileFacade(file);
}
}
private void UpdateFileFacade(FileFacade facade)
{
var assemblyNameTuples = new Dictionary();
foreach (var assemblyTuple in this.Section.Tuples.OfType())
{
assemblyNameTuples.Add(assemblyTuple.ComponentRef + "/" + assemblyTuple.Name, assemblyTuple);
}
FileInfo fileInfo = null;
try
{
fileInfo = new FileInfo(facade.File.Source.Path);
}
catch (ArgumentException)
{
this.Messaging.Write(ErrorMessages.InvalidFileName(facade.File.SourceLineNumbers, facade.File.Source.Path));
return;
}
catch (PathTooLongException)
{
this.Messaging.Write(ErrorMessages.InvalidFileName(facade.File.SourceLineNumbers, facade.File.Source.Path));
return;
}
catch (NotSupportedException)
{
this.Messaging.Write(ErrorMessages.InvalidFileName(facade.File.SourceLineNumbers, facade.File.Source.Path));
return;
}
if (!fileInfo.Exists)
{
this.Messaging.Write(ErrorMessages.CannotFindFile(facade.File.SourceLineNumbers, facade.File.Id.Id, facade.File.Name, facade.File.Source.Path));
return;
}
using (var fileStream = new FileStream(fileInfo.FullName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
if (Int32.MaxValue < fileStream.Length)
{
throw new WixException(ErrorMessages.FileTooLarge(facade.File.SourceLineNumbers, facade.File.Source.Path));
}
facade.File.FileSize = Convert.ToInt32(fileStream.Length, CultureInfo.InvariantCulture);
}
string version = null;
string language = null;
try
{
Installer.GetFileVersion(fileInfo.FullName, out version, out language);
}
catch (Win32Exception e)
{
if (0x2 == e.NativeErrorCode) // ERROR_FILE_NOT_FOUND
{
throw new WixException(ErrorMessages.FileNotFound(facade.File.SourceLineNumbers, fileInfo.FullName));
}
else
{
throw new WixException(ErrorMessages.Win32Exception(e.NativeErrorCode, e.Message));
}
}
// If there is no version, it is assumed there is no language because it won't matter in the versioning of the install.
if (String.IsNullOrEmpty(version)) // unversioned files have their hashes added to the MsiFileHash table
{
if (!this.OverwriteHash)
{
// not overwriting hash, so don't do the rest of these options.
}
else if (null != facade.File.Version)
{
// Search all of the file rows available to see if the specified version is actually a companion file. Yes, this looks
// very expensive and you're probably thinking it would be better to create an index of some sort to do an O(1) look up.
// That's a reasonable thought but companion file usage is usually pretty rare so we'd be doing something expensive (indexing
// all the file rows) for a relatively uncommon situation. Let's not do that.
//
// Also, if we do not find a matching file identifier then the user provided a default version and is providing a version
// for unversioned file. That's allowed but generally a dangerous thing to do so let's point that out to the user.
if (!this.FileFacades.Any(r => facade.File.Version.Equals(r.File.Id.Id, StringComparison.Ordinal)))
{
this.Messaging.Write(WarningMessages.DefaultVersionUsedForUnversionedFile(facade.File.SourceLineNumbers, facade.File.Version, facade.File.Id.Id));
}
}
else
{
if (null != facade.File.Language)
{
this.Messaging.Write(WarningMessages.DefaultLanguageUsedForUnversionedFile(facade.File.SourceLineNumbers, facade.File.Language, facade.File.Id.Id));
}
int[] hash;
try
{
Installer.GetFileHash(fileInfo.FullName, 0, out hash);
}
catch (Win32Exception e)
{
if (0x2 == e.NativeErrorCode) // ERROR_FILE_NOT_FOUND
{
throw new WixException(ErrorMessages.FileNotFound(facade.File.SourceLineNumbers, fileInfo.FullName));
}
else
{
throw new WixException(ErrorMessages.Win32Exception(e.NativeErrorCode, fileInfo.FullName, e.Message));
}
}
if (null == facade.Hash)
{
facade.Hash = new MsiFileHashTuple(facade.File.SourceLineNumbers, facade.File.Id);
this.Section.Tuples.Add(facade.Hash);
}
facade.Hash.Options = 0;
facade.Hash.HashPart1 = hash[0];
facade.Hash.HashPart2 = hash[1];
facade.Hash.HashPart3 = hash[2];
facade.Hash.HashPart4 = hash[3];
}
}
else // update the file row with the version and language information.
{
// If no version was provided by the user, use the version from the file itself.
// This is the most common case.
if (String.IsNullOrEmpty(facade.File.Version))
{
facade.File.Version = version;
}
else if (!this.FileFacades.Any(r => facade.File.Version.Equals(r.File.Id.Id, StringComparison.Ordinal))) // this looks expensive, but see explanation below.
{
// The user provided a default version for the file row so we looked for a companion file (a file row with Id matching
// the version value). We didn't find it so, we will override the default version they provided with the actual
// version from the file itself. Now, I know it looks expensive to search through all the file rows trying to match
// on the Id. However, the alternative is to build a big index of all file rows to do look ups. Since this case
// where the file version is already present is rare (companion files are pretty uncommon), we'll do the more
// CPU intensive search to save on the memory intensive index that wouldn't be used much.
//
// Also note this case can occur when the file is being updated using the WixBindUpdatedFiles extension mechanism.
// That's typically even more rare than companion files so again, no index, just search.
facade.File.Version = version;
}
if (!String.IsNullOrEmpty(facade.File.Language) && String.IsNullOrEmpty(language))
{
this.Messaging.Write(WarningMessages.DefaultLanguageUsedForVersionedFile(facade.File.SourceLineNumbers, facade.File.Language, facade.File.Id.Id));
}
else // override the default provided by the user (usually nothing) with the actual language from the file itself.
{
facade.File.Language = language;
}
// Populate the binder variables for this file information if requested.
if (null != this.VariableCache)
{
if (!String.IsNullOrEmpty(facade.File.Version))
{
var key = String.Format(CultureInfo.InvariantCulture, "fileversion.{0}", facade.File.Id.Id);
this.VariableCache[key] = facade.File.Version;
}
if (!String.IsNullOrEmpty(facade.File.Language))
{
var key = String.Format(CultureInfo.InvariantCulture, "filelanguage.{0}", facade.File.Id.Id);
this.VariableCache[key] = facade.File.Language;
}
}
}
// If this is a CLR assembly, load the assembly and get the assembly name information
if (AssemblyType.DotNetAssembly == facade.Assembly?.Type)
{
try
{
var assemblyName = AssemblyNameReader.ReadAssembly(facade.File.SourceLineNumbers, fileInfo.FullName, version);
this.SetMsiAssemblyName(assemblyNameTuples, facade, "name", assemblyName.Name);
this.SetMsiAssemblyName(assemblyNameTuples, facade, "culture", assemblyName.Culture);
this.SetMsiAssemblyName(assemblyNameTuples, facade, "version", assemblyName.Version);
if (!String.IsNullOrEmpty(assemblyName.Architecture))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "processorArchitecture", assemblyName.Architecture);
}
// TODO: WiX v3 seemed to do this but not clear it should actually be done.
//else if (!String.IsNullOrEmpty(file.WixFile.ProcessorArchitecture))
//{
// this.SetMsiAssemblyName(assemblyNameTuples, file, "processorArchitecture", file.WixFile.ProcessorArchitecture);
//}
if (assemblyName.StrongNamedSigned)
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "publicKeyToken", assemblyName.PublicKeyToken);
}
else if (facade.Assembly.ApplicationFileRef == null)
{
throw new WixException(ErrorMessages.GacAssemblyNoStrongName(facade.File.SourceLineNumbers, fileInfo.FullName, facade.File.ComponentRef));
}
if (!String.IsNullOrEmpty(assemblyName.FileVersion))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "fileVersion", assemblyName.FileVersion);
}
// add the assembly name to the information cache
if (null != this.VariableCache)
{
this.VariableCache[$"assemblyfullname.{facade.File.Id.Id}"] = assemblyName.GetFullName();
}
}
catch (WixException e)
{
this.Messaging.Write(e.Error);
}
}
else if (AssemblyType.Win32Assembly == facade.Assembly?.Type)
{
// TODO: Consider passing in the this.FileFacades as an indexed collection instead of searching through
// all files like this. Even though this is a rare case it looks like we might be able to index the
// file earlier.
var fileManifest = this.FileFacades.FirstOrDefault(r => r.File.Id.Id.Equals(facade.Assembly.ManifestFileRef, StringComparison.Ordinal));
if (null == fileManifest)
{
this.Messaging.Write(ErrorMessages.MissingManifestForWin32Assembly(facade.File.SourceLineNumbers, facade.File.Id.Id, facade.Assembly.ManifestFileRef));
}
try
{
var assemblyName = AssemblyNameReader.ReadAssemblyManifest(facade.File.SourceLineNumbers, fileManifest.File.Source.Path);
if (!String.IsNullOrEmpty(assemblyName.Name))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "name", assemblyName.Name);
}
if (!String.IsNullOrEmpty(assemblyName.Version))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "version", assemblyName.Version);
}
if (!String.IsNullOrEmpty(assemblyName.Type))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "type", assemblyName.Type);
}
if (!String.IsNullOrEmpty(assemblyName.Architecture))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "processorArchitecture", assemblyName.Architecture);
}
if (!String.IsNullOrEmpty(assemblyName.PublicKeyToken))
{
this.SetMsiAssemblyName(assemblyNameTuples, facade, "publicKeyToken", assemblyName.PublicKeyToken);
}
}
catch (WixException e)
{
this.Messaging.Write(e.Error);
}
}
}
///
/// Set an MsiAssemblyName row. If it was directly authored, override the value, otherwise
/// create a new row.
///
/// MsiAssemblyName table.
/// FileFacade containing the assembly read for the MsiAssemblyName row.
/// MsiAssemblyName name.
/// MsiAssemblyName value.
private void SetMsiAssemblyName(Dictionary assemblyNameTuples, FileFacade file, string name, string value)
{
// check for null value (this can occur when grabbing the file version from an assembly without one)
if (String.IsNullOrEmpty(value))
{
this.Messaging.Write(WarningMessages.NullMsiAssemblyNameValue(file.File.SourceLineNumbers, file.File.ComponentRef, name));
}
else
{
// if the assembly will be GAC'd and the name in the file table doesn't match the name in the MsiAssemblyName table, error because the install will fail.
if ("name" == name && AssemblyType.DotNetAssembly == file.Assembly.Type &&
String.IsNullOrEmpty(file.Assembly.ApplicationFileRef) &&
!String.Equals(Path.GetFileNameWithoutExtension(file.File.Name), value, StringComparison.OrdinalIgnoreCase))
{
this.Messaging.Write(ErrorMessages.GACAssemblyIdentityWarning(file.File.SourceLineNumbers, Path.GetFileNameWithoutExtension(file.File.Name), value));
}
// override directly authored value
var lookup = String.Concat(file.File.ComponentRef, "/", name);
if (!assemblyNameTuples.TryGetValue(lookup, out var assemblyNameRow))
{
assemblyNameRow = new MsiAssemblyNameTuple(file.File.SourceLineNumbers);
assemblyNameRow.ComponentRef = file.File.ComponentRef;
assemblyNameRow.Name = name;
assemblyNameRow.Value = value;
if (null == file.AssemblyNames)
{
file.AssemblyNames = new List();
}
file.AssemblyNames.Add(assemblyNameRow);
this.Section.Tuples.Add(assemblyNameRow);
}
assemblyNameRow.Value = value;
if (this.VariableCache != null)
{
var key = String.Format(CultureInfo.InvariantCulture, "assembly{0}.{1}", name, file.File.Id.Id).ToLowerInvariant();
this.VariableCache[key] = value;
}
}
}
}
}