ILRepack.FullAuto

---

What is this?

ILRepack.FullAuto is an alternative package for ILRepack related. This allows for fully automatic assembly integration simply by installing only the package ILRepack.FullAuto.

Nowadays, alternative packages for ILRepack are quite wildly available. The significance of adding yet another package to the mix is that:

• Completely automatic. There is no need to manually insert additional properties or scripts. Of course, you can manually configure optional parameters for ILRepack if you need.
• Windows and Linux are supported as operating environments.
  • On linux, mono and CoreCLR environment are valid. CoreCLR SDK version requires 6.0 or above.
  • It runs on Linux and contributes to build automation in CI environments, ex: GitHub Actions Linux VM image.
• Independed any MSBuild assemblies. Avoid strange assembly loader error related MSBuild versions.
• Use genuine ILRepack official binary comes from NuGet package.

---

Requirements

Build environments:

• .NET SDK 8, 7 and 6.
• .NET Framework SDK 4.0 or upper.

Target binaries:

• Depends on the conditions required by official ILRepack package.

---

How to use

1. Install ILRepack.FullAuto NuGet package.
2. Done :)

Default behavior is merged assemblies only on Release configuration. If you need to merge assemblies other configuration, use ILRepackTargetConfigurations like:

<PropertyGroup>
  <ILRepackTargetConfigurations>Debug;Release</ILRepackTargetConfigurations>
</PropertyGroup>

If you need to more customize, see Options section below.

---

Options

These options are PropertyGroup variables:

Property	Detail	Default
ILRepackBuildEnable	Enable ILRepack processing.	True
ILRepackTargetConfigurations	Will merge on these configuration. Need to semicolon-separated values.	Release
ILRepackParallelProcessing	Enable parallel processing.	True
ILRepackUnionTypes	Union type declarations.	True
ILRepackCopyAttributes	Copy assembly-wide attributes.	False
ILRepackPerformInternalize	Perform internalize between merged assembly declarations.	True
ILRepackRenameInternalized	Perform automatic renaming internalized declarations.	False
ILRepackExcludeInternalizeSerializable	Exclude internalizing when the type is marked serializable.	False
ILRepackAllowDuplicateResources	Allow duplicate any resources.	True
ILRepackAllowDuplicateNamespaces	Semicolon-separated namespace names (Foo.Internal;Bar.Collection.Generic)	(Empty)
ILRepackExcludeAssemblies	Semicolon-separated assembly file names (Foo.dll;Bar.dll)	(Empty)
ILRepackPerformVerboseOutput	Perform verbose log output.	False
ILRepackInsertRepackList	Insert repacking list into resource named ILRepack.List.	False
ILRepackMergeDebugSymbols	Merge debug symbols.	(Refer DebugSymbols property)
ILRepackMergeXmlDocuments	Merge xml documents.	(Refer GenerateDocumentationFile property)

---

License

Copyright (c) Kouji Matsui (@kozy_kekyo, @[email protected])

License under MIT.

---

History

• 1.6.0
  • Updated referring ILRepack to 2.0.33.
  • Adjusted the runtime engine that could be selected between OldCLR, CoreCLR and mono.
• 1.5.0
  • Updated referring ILRepack to 2.0.27.
  • Added ILRepackRenameInternalized and ILRepackExcludeInternalizeSerializable option.
  • Fixed always enabling CopyLocalLockFileAssemblies when package installed.
• 1.4.0
  • Updated referring ILRepack to 2.0.25.
• 1.3.0
  • Updated referring ILRepack new version package 2.0.22.
  • Unleashed on .NET 6.0 SDK or above.
• 1.2.0
  • Fixed omissions in ILRepackMergeDebugSymbols.
• 1.1.0
  • Fixed causing invalid expression for ILRepackMergeDebugSymbols evaluation.
• 1.0.0
  • Supported additional option properties.
• 0.1.0
  • Initial release