KageKirin.ILRepack.MSBuild.Task contains tasks for MSBuild to run ILRepack over a freshly compiled assembly,
in order to infuse it with select IL code of its dependencies.
This is the tool variant. It requires having ILRepack installed.
This is the lib variant. It's standalone and ILRepack.Lib has been merged into it.
dotnet add package KageKirin.ILRepack.Tool.MSBuild.Task ## tool version
dotnet add package KageKirin.ILRepack.Lib.MSBuild.Task ## lib version<Project>
<ItemGroup>
<!-- either -->
<PackageReference Include="KageKirin.ILRepack.Tool.MSBuild.Task" Version="0.3.0" />
<!-- or -->
<PackageReference Include="KageKirin.ILRepack.Lib.MSBuild.Task" Version="0.3.0" />
</ItemGroup>
</Project>ILRepack.Tool.MSBuild.Task and ILRepack.Lib.MSBuild.Task can be used interchangeably as both use the same properties and items.
Therefore it is not recommended to use both in the same project.
The task can be used in 2 manners:
- using the default target that relies on configuration only
- use=ing a custom target that calls the
ILRepacktask.
Global configuration goes into a solution-wide Directory.Build.props as usual,
per-project configuration can go into each .csproj project file, or preferrably
into ILRepack.Configuration.props.
I do recommend using a per-project ILRepack.Configuration.props residing next to the project.
Custom targets ought to be handled per-project and go into a ILRepack.targets file residing next to the project.
The ILRepack exposes a number of parameters that have their equivalent in the form of ILRepackXXX properties or items
(which then get internally forward to the aforementioned task).
Most of those parameters/properties correspond directly to the command line arguments that ILRepack.exe can take, respectively,
to the fields of ILRepacking.RepackOptions used internally by the ILRepack.dll library.
For the record, properties go into a (read one or more) <PropertyGroup> container.
<Project>
<PropertyGroup>
<!-- properties go here -->
</PropertyGroup>
</Project><ILRepackProperty> |
ILRepack task parameter |
corresponding ILRepack.exe argument |
summary |
|---|---|---|---|
<ILRepackParallel> |
Parallel |
/parallel |
use as many CPUs as possible to merge the assemblies |
<ILRepackDebugInfo> |
DebugInfo |
/ndebug (when omitted) |
enables symbol file generation. explcitly set to false to disable default behaviour. |
<ILRepackLogVerbose> |
LogVerbose |
/verbose |
more detailed logging |
<ILRepackInternalize> |
Internalize |
/internalize |
make all types except in the first assembly 'internal'. Types in the transitive closure of public API remain public. |
<ILRepackRenameInternalized> |
RenameInternalized |
/renameinternalized |
rename each internalized type to a new unique name |
<ILRepackAllowWildCards> |
AllowWildCards |
/wildcards |
allows (and resolves) file wildcards (e.g. *.dll) in input assemblies |
<ILRepackDelaySign> |
DelaySign |
/delaysign |
set the key, but don't sign the assembly |
<ILRepackExcludeInternalizeSerializable> |
ExcludeInternalizeSerializable |
/excludeinternalizeserializable |
do not internalize types marked as Serializable |
<ILRepackUnionMerge> |
UnionMerge |
/union |
merges types with identical names into one |
<ILRepackAllowAllDuplicateTypes> |
AllowAllDuplicateTypes |
/allowdup |
if no other /allowdup arguments specified, allow all duplicate types. (see <ILRepackAllowDuplicateTypes> below for more information) |
<ILRepackAllowDuplicateResources> |
AllowDuplicateResources |
/allowduplicateresources |
allows to duplicate resources in output assembly (by default they're ignored) |
<ILRepackNoRepackRes> |
NoRepackRes |
/noRepackRes |
do not add the resource 'ILRepack.List' with all merged assembly names |
<ILRepackCopyAttributes> |
CopyAttributes |
/copyattrs |
copy assembly attributes (by default only the primary assembly attributes are copied) |
<ILRepackAllowMultipleAssemblyLevelAttributes> |
AllowMultipleAssemblyLevelAttributes |
/allowMultiple |
when copyattrs is specified, allows multiple attributes (if type allows) |
<ILRepackKeepOtherVersionReferences> |
KeepOtherVersionReferences |
/keepotherversionreferences |
take reference assembly version into account when removing references |
<ILRepackPreserveTimestamp> |
PreserveTimestamp |
/preservetimestamp |
preserve original file PE timestamp |
<ILRepackSkipConfigMerge> |
SkipConfigMerge |
/skipconfig |
skips merging config files |
<ILRepackMergeIlLinkerFiles> |
MergeIlLinkerFiles |
/illink |
merge IL Linker files |
<ILRepackXmlDocumentation> |
XmlDocumentation |
/xmldocs |
merges XML documentation as well |
<ILRepackAllowZeroPeKind> |
AllowZeroPeKind |
/zeropekind |
allows assemblies with Zero PeKind (but obviously only IL will get merged) |
<ILRepackLineIndexation> |
LineIndexation |
/index |
stores file:line debug information as type/method attributes (requires PDB) |
<ILRepackPauseBeforeExit> |
PauseBeforeExit |
/pause |
pause execution once completed, good for debugging, don't use for CI/CD |
<ILRepackClosed> |
Closed |
/closed |
NOT IMPLEMENTED |
<ILRepackProperty> |
ILRepack task parameter |
corresponding ILRepack.exe argument |
summary |
|---|---|---|---|
<ILRepackVersion> |
Version |
/ver:M.X.Y.Z |
target assembly version |
<ILRepackTargetKind> |
TargetKind |
/target:kind |
target assembly kind [library |
<ILRepackTargetPlatformDirectory> |
TargetPlatformDirectory |
/targetplatform:P (first part of P) |
specify target platform path |
<ILRepackTargetPlatformVersion> |
TargetPlatformVersion |
/targetplatform:P (second part of P) |
specify target platform version (v1, v1.1, v2, v4 supported) |
<ILRepackProperty> |
ILRepack task parameter |
corresponding ILRepack.exe argument |
summary |
|---|---|---|---|
<ILRepackFileAlignment> |
FileAlignment |
/align |
NOT IMPLEMENTED |
<ILRepackTimeout> |
Timeout |
timeout to end task in seconds. This is a special value that allows to terminate the ILRepack task after the specified time to avoid endless loops eating up precious CI time. |
For the record, items go into a (read one or more) <ItemGroup> container.
<Project>
<ItemGroup>
<!-- items go here -->
</ItemGroup>
</Project><ILRepackItem> |
ILRepack task parameter |
corresponding ILRepack.exe argument |
summary |
|---|---|---|---|
<ILRepackOutputFile> |
OutputFile |
/out:<path> |
target assembly path, symbol/config/doc files will be written here as well |
<ILRepackInputAssemblies> |
InputAssemblies |
paths to input assemblies in the following order: - primary assembly: gives the name, version to the merged one - other assemblies: other assemblies to merge with the primary one |
<ILRepackItem> |
ILRepack task parameter |
corresponding ILRepack.exe argument |
summary |
|---|---|---|---|
<ILRepackLogFile> |
LogFile |
/log:<logfile> |
enable logging to the given file (default is disabled) |
<ILRepackLibraryPaths> |
LibraryPaths |
/lib:<path> |
path(s) to search directories to resolve referenced assemblies (can be specified multiple times). If you get 'unable to resolve assembly' errors specify a path to a directory where the assembly can be found. |
<ILRepackInternalizeExclude> |
InternalizeExclude |
/internalize:<exclude_file> |
each item is either a regex or a full type name not to internalize, or an assembly name not to internalize (.dll extension optional). Internally, each item is written line-by-line into a ILRepack.not file that gets passed as |
<ILRepackInternalizeAssemblies> |
InternalizeAssemblies |
/internalizeassembly:<path> |
internalize a specific assembly name (no extension). May be specified more than once (one per assembly to internalize). If specified, no need to also specify /internalize. |
<ILRepackKeyFile> |
KeyFile |
/keyfile:<path> |
keyfile to sign the output assembly |
<ILRepackKeyContainer> |
KeyContainer |
/keycontainer:<c> |
key container |
<ILRepackAllowedDuplicateTypes> |
AllowedDuplicateTypes |
/allowdup:Type |
keep duplicates of the specified type, may be specified more than once |
<ILRepackRepackDropAttributes> |
DropAttributes |
/repackdrop:RepackDropAttribute |
allows dropping members denoted by this attribute name when merging |
<ILRepackImportAttributeAssemblies> |
ImportAttributeAssemblies |
/attr:<path> |
take assembly attributes from the given assembly file |
<ILRepackFilterAssemblies> |
FilterAssemblies |
optional list of assemblies (partial names or regex) to keep among all the input assemblies. Non-matching ones are discarded from the inputs. The reason for this is that filtering the sometimes many input assemblies using only MSBuild functions is rather complex, whereas this simple list simplifies the process extremely. |
Please refer to COLLABORATION.md.
