Introduction
Whoever searched for a solution to merge multiple assemblies into a single file probably heard of tools like ILMerge, SmartAssembly, etc.
Another known solution is embedding the DLLs as resources (if anyone's interested, here is a nice article that explains this approach: Load DLL From Embedded Resource[^]).
However on few occasions, I noticed an unnecessary use of these approaches.
If we have these assemblies source codes, then we can achieve the combining by importing all the source code files into a single project at compile time.
In this tip, I'll try to explain briefly how to accomplish that.
For demonstration purposes, let's say we have a console application (our main assembly) that references and uses two class libraries (our secondary assemblies) and we want to combine them all into a single file:
When building this solution, we get three assemblies as expected:
Note that MyExecutable
's project file (MyExecutable.csproj) is an XML based file and if we inspect its contents, we can find few ItemGroup
nodes. These nodes contain child elements that define the build processes inputs. These child elements can refer to application's source files that need to be compiled, or resource files that need to be copied or assemblies that need to be included in the build process (if anyone's interested, you can read more about Visual Studio project files on MSDN MSBuild).
Now let's locate the ItemGroup
node that refers to our included assemblies:
<ItemGroup>
<ProjectReference Include="..\MyLibrary1\MyLibrary1.csproj">
<Project>{ea53ca82-13d7-4be1-b95a-4d9d7853d46e}</Project>
<Name>MyLibrary1</Name>
</ProjectReference>
<ProjectReference Include="..\MyLibrary2\MyLibrary2.csproj">
<Project>{c31d21f3-e86a-4581-b4e8-acae6644d19e}</Project>
<Name>MyLibrary2</Name>
</ProjectReference>
</ItemGroup>
Here, we will add a condition that will indicate to MSBuild to use these project references when building MyExecutable
in Debug
mode:
<ItemGroup Condition=" '$(Configuration)' == 'Debug' ">
But for Release
mode, we will include all the source code files from both MyLibrary1
and MyLibrary2
to be compiled as well. We will do this by using a wild card ("\**\*.cs"
) that will include all the CS files in the directory and its subdirectories. The wild card will also include some unwanted source code files (for this case, those are TemporaryGeneratedFile_[guid].cs files in obj folder and AssemblyInfo.cs file in Property folder) so we will have to exclude them:
<ItemGroup Condition=" '$(Configuration)' == 'Release' ">
<Compile Include="..\MyLibrary1\**\*.cs"
Exclude="..\MyLibrary1\Properties\AssemblyInfo.cs;
..\MyLibrary1\obj\**;
..\MyLibrary1\bin\**">
<Link>MyLibrary1\%(RecursiveDir)%(Filename)%(Extension)</Link>
<Visible>false</Visible>
</Compile>
<Compile Include="..\MyLibrary2\**\*.cs"
Exclude="..\MyLibrary2\Properties\AssemblyInfo.cs;
..\MyLibrary2\obj\**;
..\MyLibrary2\bin\**">
<Link>MyLibrary2\%(RecursiveDir)%(Filename)%(Extension)</Link>
<Visible>false</Visible>
</Compile>
</ItemGroup>
And that is it, let's save these changes in MyExecutable.csproj file and rebuild the solution in Release
mode:
Last thing I would like to emphasize as a sort of troubleshooting advice, because we are literally moving the compilation of all assemblies source files into a single project, that project needs to be able to compile those files. So you need to consider the following:
- The main assembly needs to have all the references, resources, settings, etc. of the secondary assemblies in order to build successfully.
- All assemblies need to be written in the same .NET language.