Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles
(untagged)

Combining Multiple .NET Assemblies

0.00/5 (No votes)
20 Mar 2015 4  
Combining multiple .NET assemblies by customizing MSBuild's project file.

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:

XML
<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:

XML
<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:

XML
<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.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here