ILRepack.Lib 2.0.36

dotnet add package ILRepack.Lib --version 2.0.36                
NuGet\Install-Package ILRepack.Lib -Version 2.0.36                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ILRepack.Lib" Version="2.0.36" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ILRepack.Lib --version 2.0.36                
#r "nuget: ILRepack.Lib, 2.0.36"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install ILRepack.Lib as a Cake Addin
#addin nuget:?package=ILRepack.Lib&version=2.0.36

// Install ILRepack.Lib as a Cake Tool
#tool nuget:?package=ILRepack.Lib&version=2.0.36                

Build status NuGet GitHub license
Gitter chat

Introduction

ILRepack is meant at replacing ILMerge / Mono.Merge.

The former being closed-source (now open-sourced), impossible to customize, slow, resource consuming and many more. The later being deprecated, unsupported, and based on an old version of Mono.Cecil.

Here we're using latest (slightly modified) Cecil sources (0.11.5), you can find the fork here.

Downloads

You can grab it using NuGet.

Or if you're old-school (and want to stay like that), this direct link will give you the latest nupkg file, which you can open as a zip file.

Dotnet Tool Installation

ILRepack can now be installed as a dotnet tool:

PS C:\> dotnet tool install -g dotnet-ilrepack

You can then run ILRepack using ilrepack.

[!Note] There's no need to use dotnet ilrepack, as the way the tool is installed into the dotnet tools path, all you need to do is issue the command ilrepack.

Syntax

A console application is available (can be used as DLL as well), using same syntax as ILMerge:

Syntax: ILRepack.exe [options] /out:<path> <path_to_primary> [<other_assemblies> ...]

 - /help                displays this usage
 - /keyfile:<path>      specifies a keyfile to sign the output assembly
 - /keycontainer:<name> specifies a key container to sign the output assembly (takes precedence over /keyfile)
 - /log:<logfile>       enable logging (to a file, if given) (default is disabled)
 - /ver:M.X.Y.Z         target assembly version
 - /union               merges types with identical names into one
 - /ndebug              disables symbol file generation
 - /copyattrs           copy assembly attributes (by default only the primary assembly attributes are copied)
 - /attr:<path>         take assembly attributes from the given assembly file
 - /allowMultiple       when copyattrs is specified, allows multiple attributes (if type allows)
 - /target:kind         specify target assembly kind (library, exe, winexe supported, default is same as first assembly)
 - /targetplatform:P    specify target platform (v1, v1.1, v2, v4 supported)
 - /xmldocs             merges XML documentation as well
 - /lib:<path>          adds the path to the search directories for referenced assemblies (can be specified multiple times)
 - /internalize[:<excludefile>]  sets all types but the ones from the first assembly 'internal'. <excludefile> contains one regex per
                                 line to compare against FullName of types NOT to internalize.
 - /renameInternalized  rename all internalized types
 - /excludeinternalizeserializable do not internalize types marked as Serializable
 - /delaysign           sets the key, but don't sign the assembly
 - /usefullpublickeyforreferences - NOT IMPLEMENTED
 - /align               - NOT IMPLEMENTED
 - /closed              - NOT IMPLEMENTED
 - /allowdup:Type       allows the specified type for being duplicated in input assemblies
 - /allowduplicateresources allows to duplicate resources in output assembly (by default they're ignored)
 - /zeropekind          allows assemblies with Zero PeKind (but obviously only IL will get merged)
 - /wildcards           allows (and resolves) file wildcards (e.g. `*`.dll) in input assemblies
 - /parallel            use as many CPUs as possible to merge the assemblies
 - /pause               pause execution once completed (good for debugging)
 - /repackdrop:AttributeClass allows dropping specific members during merging (#215)
 - /verbose             shows more logs
 - /out:<path>          target assembly path, symbol/config/doc files will be written here as well
 - <path_to_primary>    primary assembly, gives the name, version to the merged one
 - <other_assemblies>   ...

Note: for compatibility purposes, all options can be specified using '/', '-' or '--' prefix.

How to build

Builds directly from within Visual Studio 2022, or using msbuild:

git clone --recursive https://github.com/gluck/il-repack.git
cd il-repack
msbuild

TODO

  • Crash-testing
  • Add remaining features from ILMerge (closed / align)
  • Un-fork Cecil
  • Merge import process & reference fixing

DONE

  • PDBs & MDBs should be merged (Thanks Simon)
  • Fixed internal method overriding public one which isn't allowed in the same assembly (Simon)
  • Attribute merge (/copyattrs)
  • XML documentation merge
  • Clean command line parameter parsing
  • Add usage / version
  • App.config merge
  • Internalizing types (Simon)
  • Delay signing (Simon)
  • Target platform selection (Simon)
  • Automatic internal type renaming

Sponsoring / Donations

If you like this tool and want to express your thanks, you can contribute either time to the project (issue triage or pull-requests) or donate money to the Free Software Foundation.

Donate

Product Compatible and additional computed target framework versions.
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on ILRepack.Lib:

Package Downloads
OTAPI.Patcher

The Patching Engine for the Open Terraria API (OTAPI)

MockEverything

A tampering mechanism which makes it possible to rewrite methods, getters, setters and constructors of third-party libraries used by the tested code.

GitHub repositories (3)

Showing the top 3 popular GitHub repositories that depend on ILRepack.Lib:

Repository Stars
realm/realm-dotnet
Realm is a mobile database: a replacement for SQLite & ORMs
Thealexbarney/VGAudio
A library for encoding, decoding, and manipulating audio files from video games.
ravibpatel/ILRepack.Lib.MSBuild.Task
MSBuild task for ILRepack which is an open-source alternative to ILMerge.
Version Downloads Last updated
2.0.36 115 12/10/2024
2.0.35 480 10/2/2024
2.0.34 625 6/10/2024
2.0.33 652 5/10/2024
2.0.32 203 5/6/2024
2.0.31 222 4/21/2024
2.0.30 173 4/5/2024
2.0.28 187 3/19/2024
2.0.26 487 1/10/2024
2.0.25 183 1/8/2024
2.0.24 168 1/7/2024
2.0.18 34,759 9/8/2019
2.0.17 1,236 5/21/2019
2.0.16 11,251 7/30/2018
2.0.15 14,180 12/7/2017
2.0.14 1,063 11/21/2017
2.0.13 4,776 4/6/2017
2.0.12 2,530 10/24/2016
2.0.11 1,118 8/22/2016
2.0.10 2,980 1/8/2016
2.0.9 1,214 12/16/2015
2.0.8 1,577 10/6/2015
2.0.7 1,423 10/5/2015
2.0.5 1,375 8/19/2015
2.0.4 1,337 7/30/2015
2.0.3 1,295 7/22/2015
2.0.2 1,441 6/18/2015
2.0.1 1,166 6/14/2015
2.0.0 1,194 6/7/2015
1.26.0 1,391 5/2/2015
1.25.0 2,349 2/17/2014
1.24.0 1,261 1/20/2014
1.23.0 1,267 12/16/2013
1.22.2 1,768 3/3/2013
1.22.1 1,278 3/3/2013
1.22.0 1,423 3/3/2013