75

I have two DLL files which I'd like to include in my EXE file to make it easier to distribute it. I've read a bit here and there how to do this, even found a good thread here, and here, but it's far too complicated for me and I need real basic instructions on how to do this.

I'm using Microsoft Visual C# Express 2010, and please excuse my "low standard" question, but I feel like I'm one or two level below everyone else's expercise :-/ If someone could point out how to merge these DDL files into my EXE in a step-by-step guide, this would be really awesome!

0

13 Answers 13

98

For .NET Framework 4.5

ILMerge.exe /target:winexe /targetplatform:"v4,C:\Program Files\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0" /out:finish.exe insert1.exe insert2.dll

ILMerge

  1. Open CMD and cd to your directory. Let's say: cd C:\test
  2. Insert the above code.
  3. /out:finish.exe replace finish.exe with any filename you want.
  4. Behind the /out:finish.exe you have to give the files you want to be combined.
4
  • 1
    Hurray, that worked. The problem was a "\" at the end of the directory path which was too much.
    – Momro
    Commented Apr 13, 2012 at 10:40
  • 7
    I just followed your instructions as you mention above. still not merged. please help me. In Command Prompt : ILMerge.exe /target:winexe /targetplatform:"v4,C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0" /out:finish.exe myExe.exe mfc100u.dll mfc110u.dll msvcp110.dll Error: An exception occurred during merging: ILMerge.Merge: Could not load assembly from the location 'C:\test\my folder\mfc 100u.dll'. Skipping and processing rest of arguments. Any idea whats gonin wrong ?
    – AB Bolim
    Commented Oct 27, 2013 at 7:24
  • 3
    Sometimes you have to 1) use Program Files (x86) 2) type the full path to ILMerge. Use /target:exe for console applications.
    – SWdV
    Commented Nov 25, 2017 at 22:53
  • Windows by-default comes with .NET framework here C:\Windows\Microsoft.NET\Framework. So you can also use /targetplatform:"v2,C:\Windows\Microsoft.NET\Framework\v2.0.50727" or /targetplatform:"v4,C:\Windows\Microsoft.NET\Framework\v4.0.30319" Commented Oct 7, 2021 at 12:47
42

Use Costura.Fody.

You just have to install the nuget and then do a build. The final executable will be standalone.

4
  • 1
    this is a very interesting project. but it seems to be a plugin for Fody.. so you could improve this answer a bit by providing some information on Mono.Cecil and Fody (as they are both dependencies, and are really the most relevant to the underline premise). But, yea, the plugin itself does seem to make it 'easier' to embed and distribute dlls in a configurable manner. Commented Nov 24, 2016 at 12:49
  • 7
    This is voodoo. Unbelievably easy. Install-Package Costura.Fody and Bam! your build will produce one big fat exe. Commented Sep 5, 2017 at 16:21
  • 1
    Doesnt quite work but i support this is can happen in some cases. (Can't build and i have an error) Commented May 19, 2018 at 13:12
  • Wow - I struggled for 3 days trying to get iLMerge to work with several 3rd party dlls that had multiple other references I had to point to, and even though I had all dependencies added it still did not work and upon examining the logs it was mutating some of the namespace names, saying they were duplicate. (They were inside the 3rd party assemblies) This worked just as easy as @CristianDiaconescu said.
    – cmartin
    Commented Jan 12, 2021 at 21:04
25

Download ilmerge and ilmergre gui . makes joining the files so easy ive used these and works great

0
18

Reference the DLL´s to your Resources and and use the AssemblyResolve-Event to return the Resource-DLL.

public partial class App : Application
{
    public App()
    {
        AppDomain.CurrentDomain.AssemblyResolve += (sender, args) =>
        {

            Assembly thisAssembly = Assembly.GetExecutingAssembly();

            //Get the Name of the AssemblyFile
            var name = args.Name.Substring(0, args.Name.IndexOf(',')) + ".dll";

            //Load form Embedded Resources - This Function is not called if the Assembly is in the Application Folder
            var resources = thisAssembly.GetManifestResourceNames().Where(s => s.EndsWith(name));
            if (resources.Count() > 0)
            {
                var resourceName = resources.First();
                using (Stream stream = thisAssembly.GetManifestResourceStream(resourceName))
                {
                    if (stream == null) return null;
                    var block = new byte[stream.Length];
                    stream.Read(block, 0, block.Length);
                    return Assembly.Load(block);
                }
            }
            return null;
        };
    }
}
10
  • 1
    Ok, I don't understand the slightest thing of what you wrote there ;-) Where do I have to put this code into?
    – Momro
    Commented Apr 13, 2012 at 9:46
  • Are you using a WPF or a WindowsForms Application?
    – Destructor
    Commented Apr 13, 2012 at 9:48
  • Ok, first you have to add the DLL´s to your project-Resources. Add a folder "Resources" to your Solution and just put your dll´s in there. Right click on your project -> Properties -> Resources. There click "Add Resource" and add your dll´s. After that go to your program.cs file and add the code to your Main() before everything else.
    – Destructor
    Commented Apr 13, 2012 at 9:51
  • 1
    For WinForms try this code instead of the code above: AppDomain.CurrentDomain.AssemblyResolve += (sender, arg) => { if (arg.Name.StartsWith("Your_DLL")) return Assembly.Load(Properties.Resources.Your_DLL); return null; };
    – Destructor
    Commented Apr 13, 2012 at 9:57
  • Okay, I used your shortened version, but my IDE tells me that the name "Assembly" is not available in this context :-/
    – Momro
    Commented Apr 13, 2012 at 10:13
10

Download

ILMerge

Call

ilmerge /target:winexe /out:c:\output.exe c:\input.exe C:\input.dll
4
  • Add: /target:winexe /target platform:"v4,C:\Program Files\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0" to it if you have a .NEt framework 4.5 application :). Commented Apr 13, 2012 at 9:30
  • This results in the following error message: An exception occurred during merging: Unresolved assembly reference not allowed: System.Core. - I created a bat file with the following content: ilmerge /target:winexe my_exe.exe my_dll.dll /out:merged.exe
    – Momro
    Commented Apr 13, 2012 at 9:40
  • @Momro Try with the target platform parameter ;). Commented Apr 13, 2012 at 10:02
  • 1
    Ok, so I have this command: ilmerge /target:winexe /target:platform:"v4,c:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\" /out:merged.exe my_exe.exe my_dll.dll, but the prompt says that I have to specify at least one input fil and an output file. I also exchanged the out parametre with the inputs with no result.
    – Momro
    Commented Apr 13, 2012 at 10:24
9
  1. Install ILMerge as the other threads tell you to

  2. Then go to the installation folder, by default C:\Program Files (x86)\Microsoft\ILMerge

  3. Drag your Dll's and Exes to that folder

  4. Shift-Rightclick in that folder and choose open command prompt

  5. Write

    ilmerge myExe.exe Dll1.dll /out:merged.exe
    

    Note that you should write your exe first.

There you got your merged exe. This might not be the best way if your going to do this multiple times, but the simplest one for a one time use, I would recommend putting Ilmerge to your path.

4
  • 1
    I just followed your instructions as you mention above. I have also put ilmerge to my system path. still not merged. please help me. In Command Prompt : >ilmerge myExe.exe mfc100u.dll mfc110u.dll /out:final.exe Error: An exception occurred during merging: ILMerge.Merge: Could not load assembly from the location 'C:\test\my folder\mfc 100u.dll'. Skipping and processing rest of arguments. Any idea whats gonin wrong ?
    – AB Bolim
    Commented Oct 27, 2013 at 7:03
  • Looks like your dlls name contains a space? Try putting quotes around it Commented Oct 27, 2013 at 8:45
  • Thanx for reply. But only in this my above comment, mfc100u.dll have space. I want to merge more than one dll file. I have also try ILMerge GUI. But still facing the same problem. Please help me.
    – AB Bolim
    Commented Oct 27, 2013 at 18:30
  • Could not get the above examples from other users to work, but this work perfectly. Thanks.
    – rerat
    Commented Sep 26, 2015 at 20:05
6
static class Program
{
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main()
    {
    /* PUT THIS LINE IN YOUR CLASS PROGRAM MAIN() */           
        AppDomain.CurrentDomain.AssemblyResolve += (sender, arg) => { if (arg.Name.StartsWith("YOURDLL")) return Assembly.Load(Properties.Resources.YOURDLL); return null; }; 
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form1());
    }
}

First add the DLL´s to your project-Resources. Add a folder "Resources"

6

2019 Update (just for reference):

Starting with .NET Core 3.0, this feature is supported out of the box. To take advantage of the single-file executable publishing, just add the following line to the project configuration file:

<PropertyGroup>
  <PublishSingleFile>true</PublishSingleFile>
</PropertyGroup>

Now, dotnet publish should produce a single .exe file without using any external tool.

More documentation for this feature is available at https://github.com/dotnet/designs/blob/master/accepted/single-file/design.md.

1
  • 1
    Nice, this works but you just need to specify RuntimeIdentifier or RuntimeIdentifiers and the file gains about 65.4 MB.
    – Daniel
    Commented Jul 22, 2020 at 23:04
3

Here is the official documentation. This is also automatically downloaded at step 2.

Below is a really simple way to do it and I've successfully built my app using .NET framework 4.6.1

  1. Install ILMerge nuget package either via gui or commandline:

    Install-Package ilmerge
    
  2. Verify you have downloaded it. Now Install (not sure the command for this, but just go to your nuget packages): enter image description here Note: You probably only need to install it for one of your solutions if you have multiple

  3. Navigate to your solution folder and in the packages folder you should see 'ILMerge' with an executable:

    \FindMyiPhone-master\FindMyiPhone-master\packages\ILMerge.2.14.1208\tools
    

    enter image description here

  4. Now here is the executable which you could copy over to your \bin\Debug (or whereever your app is built) and then in commandline/powershell do something like below:

    ILMerge.exe myExecutable.exe myDll1.dll myDll2.dll myDlln.dll myNEWExecutable.exe
    

You will now have a new executable with all your libraries in one!

1
  • For me it is the best way to update ILMerge, thanks @benscabbia
    – it3xl
    Commented Apr 20, 2020 at 17:03
1

I Found The Solution Below are the Stpes:-

  1. Download ILMerge.msi and Install it on your Machine.
  2. Open Command Prompt
  3. type cd C:\Program Files (x86)\Microsoft\ILMerge Preess Enter
  4. C:\Program Files (x86)\Microsoft\ILMerge>ILMerge.exe /target:winexe /targetplatform:"v4,C:\Windows\Microsoft.NET\Framework\v4.0.30319" /out:NewExeName.exe SourceExeName.exe DllName.dll

For Multiple Dll :-

C:\Program Files (x86)\Microsoft\ILMerge>ILMerge.exe /target:winexe /targetplatform:"v4,C:\Windows\Microsoft.NET\Framework\v4.0.30319" /out:NewExeName.exe SourceExeName.exe DllName1.dll DllName2.dll DllName3.dll

0

I answered a similar question for VB.NET. It shouldn't however be too hard to convert. You embedd the DLL's into your Ressource folder and on the first usage, the AppDomain.CurrentDomain.AssemblyResolve event gets fired.

If you want to reference it during development, just add a normal DLL reference to your project.

Embedd a DLL into a project

0

NOTE: if you're trying to load a non-ILOnly assembly, then

Assembly.Load(block)

won't work, and an exception will be thrown: more details

I overcame this by creating a temporary file, and using

Assembly.LoadFile(dllFile)
-2

The command should be the following script:

ilmerge myExe.exe Dll1.dll /target:winexe /targetplatform:"v4,c:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\" /out:merged.exe /out:merged.exe

Not the answer you're looking for? Browse other questions tagged or ask your own question.