https://github.com/kekyo/ilrepack.fullauto

Full automatic ILRepack executor on .NET, .NET Core and .NET Framework environments.
https://github.com/kekyo/ilrepack.fullauto

automatic ci dotnet ilrepack linux

Last synced: about 1 year ago
JSON representation

Full automatic ILRepack executor on .NET, .NET Core and .NET Framework environments.

• Host: GitHub
• URL: https://github.com/kekyo/ilrepack.fullauto
• Owner: kekyo
• License: mit
• Created: 2022-10-16T14:25:13.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-05-29T08:18:24.000Z (about 2 years ago)
• Last Synced: 2024-10-30T03:48:42.566Z (over 1 year ago)
• Topics: automatic, ci, dotnet, ilrepack, linux
• Language: C#
• Homepage:
• Size: 76.2 KB
• Stars: 21
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ILRepack.FullAuto

![ILRepack.FullAuto](Images/ILRepack.FullAuto.100.png)

[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

[![NuGet ILRepack.FullAuto](https://img.shields.io/nuget/v/ILRepack.FullAuto.svg?style=flat)](https://www.nuget.org/packages/ILRepack.FullAuto)

----

## What is this?

`ILRepack.FullAuto` is an alternative package for [ILRepack](https://github.com/gluck/il-repack) related.

This allows for fully automatic assembly integration simply by installing [only the package ILRepack.FullAuto](https://www.nuget.org/packages/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](https://www.nuget.org/packages/ILRepack.FullAuto).

2. Done :)

Default behavior is merged assemblies only on `Release` configuration.

If you need to merge assemblies other configuration, use `ILRepackTargetConfigurations` like:

```xml

  Debug;Release

```

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, @kekyo@mastodon.cloud)

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