Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ravibpatel/ilrepack.lib.msbuild.task
MSBuild task for ILRepack which is an open-source alternative to ILMerge.
https://github.com/ravibpatel/ilrepack.lib.msbuild.task
ilmerge ilrepack msbuild-task nuget
Last synced: about 11 hours ago
JSON representation
MSBuild task for ILRepack which is an open-source alternative to ILMerge.
- Host: GitHub
- URL: https://github.com/ravibpatel/ilrepack.lib.msbuild.task
- Owner: ravibpatel
- License: other
- Created: 2016-12-21T10:31:22.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-24T18:21:48.000Z (6 months ago)
- Last Synced: 2024-05-28T15:06:14.382Z (6 months ago)
- Topics: ilmerge, ilrepack, msbuild-task, nuget
- Language: C#
- Size: 72.3 KB
- Stars: 91
- Watchers: 4
- Forks: 28
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ILRepack.Lib.MSBuild.Task
MSBuild task for [ILRepack](https://github.com/gluck/il-repack) which is an open-source alternative to ILMerge.
## Install via NuGet [](https://www.nuget.org/packages/ILRepack.Lib.MSBuild.Task/) [](https://www.nuget.org/packages/ILRepack.Lib.MSBuild.Task/)
Install-Package ILRepack.Lib.MSBuild.Task
## Supported build tools
* MSBuild
## Usage
You just need to install NuGet package to merge all your project dependencies. If you want to customize the process then
you can create a file named "ILRepack.targets" in your project folder. You can create it like shown below.
### Example "ILRepack.targets"
```xml
```
## Configuration
You need to create "ILRepack.Config.props" file in your project folder to configure the behavior of
ILRepack.Lib.MSBuild.Task.
```xml
```
You can specify following options inside the <PropertyGroup> element to configure the behavior of the ILRepack
task.
### Specify your custom Targets file path
If you don't want to add "ILRepack.targets" file in your project folder then you can specify your targets file path as
shown below.
```xml
$(SolutionDir)ILRepack.targets
```
### Specify Key File to use for signing
You can specify the path of the SNK file you want to use for signing your assembly as shown below. This configuration
option only applies if you are using default targets file provided in NuGet package.
```xml
$(ProjectDir)ILRepack.snk
```
### Specify whether to clear directory after merging
If you are using default targets file then you may notice that it clears Output directory after merging dependencies.
You can turn this functionality off by setting ClearOutputDirectory to False as shown below.
```xml
False
```
## Task options
| Option | Description |
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|
| AllowDuplicateResources | Allows duplicating resources in the output assembly. |
| AllowMultiple | Allows multiple attributes (if type allows). |
| AllowedDuplicateNamespaces | Allows the specified namespaces from being duplicated into input assemblies. Multiple namespaces are delimited by ",". |
| AttributeFile | Take assembly attributes from the given assembly file. |
| CopyAttributes | Copy assembly attributes. |
| DebugInfo | Enable/disable symbol file generation. |
| DelaySign | Set the key file, but don't sign the assembly. |
| ExcludeInternalizeSerializable | Do not internalize types marked as Serializable. |
| InputAssemblies | List of assemblies that will be merged. |
| Internalize | Set all types but the ones from the first assembly 'internal'. |
| InternalizeAssembly | Internalize only specific assemblies (list of assembly names without path or extension). |
| InternalizeExclude | If Internalize is set to true, any which match these regular expressions will not be internalized. If Internalize is false, then this property is ignored. |
| KeyContainer | Specifies a key container to use. |
| KeyFile | Specifies a key file to sign the output assembly. |
| LibraryPath | List of paths to use as "include directories" when attempting to merge assemblies. |
| LogFile | Specifies a log file to output log information. |
| MergeIlLinkerFiles | Merge IL Linker file XML resources from Microsoft assemblies (optional). Same-named XML resources ('ILLink.*.xml') will be combined during merging. |
| NoRepackRes | Does not add the embedded resource 'ILRepack.List' with all merged assembly names. |
| OutputFile | Output name for the merged assembly. |
| Parallel | Use as many CPUs as possible to merge the assemblies. |
| PauseBeforeExit | Pause execution once completed (good for debugging). |
| RenameInternalized | Rename all internalized types (to be used when Internalize is enabled). |
| RepackDropAttribute | Name of an attribute (optional). Members in input assemblies marked with this attribute will be dropped during merging. |
| TargetKind | Target assembly kind (Exe\|Dll\|WinExe\|SameAsPrimaryAssembly) |
| TargetPlatformDirectory | Path of Directory where the target platform is located. |
| TargetPlatformVersion | Target platform (v1, v1.1, v2, v4 supported). |
| Union | Merges types with identical names into one. |
| Verbose | Additional debug information during the merge that will be outputted to LogFile. |
| Wildcards | Allows (and resolves) file wildcards (e.g., `*.dll`) in input assemblies. |
| XmlDocumentation | Merge assembly XML documentation. |
| ZeroPeKind | Allows assemblies with Zero PeKind (but obviously only IL will get merged). |