Rename assemblies and fixes references. Designed as an alternative to Costura, ILMerge, and ILRepack.

See Milestones for release notes.

Designed to mitigate scenarios where an assembly is run in a plugin scenario. For example Unity extensions, MSBuild tasks, or SharePoint extensions. In these scenarios an assembly, and all its references, are loaded into a shared AppDomain. So dependencies operate as "first on wins". So, for example, if two addins assemblies use different versions of Newtonsoft, the first addin that is loaded defines what version of Newtonsoft is used by all subsequent addins assemblies.

This project works around this problem by renaming references and preventing name conflicts.

https://www.nuget.org/packages/Alias/

.net 6 or higher is required to run this tool.

For a given directory and a subset of assemblies:

• Changes the assembly name of each "alias" assembly.
• Renames "alias" assemblies on disk.
• For all assemblies, fixes the references to point to the new alias assemblies.

Ensure dotnet CLI is installed.

Install Alias

dotnet tool install --global Alias

assemblyalias --target-directory "C:/Code/TargetDirectory"
              --suffix _Alias
              --assemblies-to-alias "Microsoft*;System*;EmptyFiles"

-t or --target-directory

Optional. If no directory is passed the current directory will be used.

-i or --internalize

Optional. To internalize all types in the aliased assemblies. Defaults to false.

Either a prefix or suffix must be defined.

-p or --prefix

The prefix to use when renaming assemblies.

-s or --suffix

The suffix to use when renaming assemblies.

-a or --assemblies-to-alias

Required. A semi-colon separated list of assembly names to alias. Names ending in * are treated as wildcards.

-e or --assemblies-to-exclude

Optional. A semi-colon separated list of assembly names to exclude.

-k or --key

Path to an snk file.

Optional. If no key is passed, strong naming will be removed from all assemblies.

-r or --references

Optional. A semi-colon separated list of paths to reference files.

--reference-file

Optional. A path to a file containing references file paths. One file path per line.

By default the target directory will be scanned for a reference file named alias-references.txt

It can be helpful to extract reference during a build using msbuild and write them to a file accessible to Alias:

<Target Name="WriteReferenceForAlias" AfterTargets="AfterCompile">
  <ItemGroup>
    <ReferenceForAlias Include="@(ReferencePath)" Condition="'%(FileName)' == 'CommandLine'" />
  </ItemGroup>
  <WriteLinesToFile File="$(TargetDir)/alias-references.txt" Lines="%(ReferenceForAlias.FullPath)" Overwrite="true" />
</Target>

^{snippet source | anchor}