How to compile a .NET application to native code?

Question

Let's say I want to run a .NET application on a machine where the .NET framework is not available; Is there any way to compile the application to native code?

score 45 · Accepted Answer · answered Sep 05 '08 at 12:50

45

Microsoft has an article describing how you can Compile MSIL to Native Code

You can use Ngen.

The Native Image Generator (Ngen.exe) is a tool that improves the performance of managed applications. Ngen.exe creates native images, which are files containing compiled processor-specific machine code, and installs them into the native image cache on the local computer. The runtime can use native images from the cache instead using the just-in-time (JIT) compiler to compile the original assembly.

Unfortunately, you still need the libraries from the framework in order to run your program. There's no feature that I know of with the MS .Net framework SDK that allows you to compile all the required files into a single executable

answered Sep 05 '08 at 12:50

Espo

41,399
21
132
159

1

I don't find any other reason to use this other than performances. The CLR code can still be read as before, and you still require .NET. So disappointing Microsoft didn't provide with a tool that would fix what I consider to be a big problem (anyone can view your high-level code as it is) – MasterMastic Dec 21 '12 at 20:15
I do not agree with Espo. Because, the text in grey says the "Runtime" which means the CLR and thus the .NET Framework that comes into picture as rightly pointed by Chris. However, NGen point is true. The question is, without using CLR/Runtime/.NET Framework all are same. – Jasmine Feb 11 '13 at 05:29
2

It is time to get excited however, looks like the .net framework is finally getting a native compiler - http://msdn.microsoft.com/en-US/vstudio/dotnetnative – ferventcoder Sep 04 '14 at 13:02
ILMerge your .NET executable and everything in its dependency tree then Ngen if you want an executable _independent of .NET_. – Apr 09 '20 at 15:15

score 34 · Answer 2 · edited Feb 08 '17 at 15:08

34

As some of the other answers here have mentioned, you can use the .NET Native tool to compile your app to native machine code. Unlike those answers, however, I will explain how to do it.

Steps:

Install the dotnet CLI (command line interface) tool, which is part of the new .NET Core toolchain. We'll use this to compile our app; you can find a good article about it here.
Open up a shell prompt and cd to the directory of your app.
Type this:
```
dotnet compile --native
```

That's it! When you're done, your app will be compiled down to a single binary, like this:

Native compiled .NET Core EXE

It'll be a standalone executable; no PDBs, assemblies, or config files included (hooray!).

Alternatively, if you want an even faster program, you can run this:

dotnet compile --native --cpp

That will optimize your program using the C++ code generator (as opposed to RyuJIT), so your app is even more optimized for AOT scenarios.

You can find more info on this at the dotnet CLI GitHub repo.

edited Feb 08 '17 at 15:08

Community

1
1

answered Feb 17 '16 at 20:48

James Ko

32,215
30
128
239

Note: this is only supported against projects built with .NET Core. (+1, though) – Mahmoud Al-Qudsi Jan 19 '17 at 21:22
1

You forgot the very important detail that .NET Native requires Windows 10. – Elmue Nov 06 '18 at 03:34
1

looks like not work with .net core 3.1 any updates ? – user1005462 Oct 04 '20 at 13:59
1

`dotnet compile` is not available when I tried. Maybe `dotnet build --self-contained` is equivalent. – Quirin F. Schroll Jul 04 '22 at 12:30

score 24 · Answer 3 · answered Sep 05 '08 at 12:51

24

RemoteSoft makes a tool that compiles a .NET application into a package that can be run without .NET installed. I don't have any experience with it:

RemoteSoft Salamander

answered Sep 05 '08 at 12:51

Simon Steele

11,558
4
45
67

6

That's the only tool I've ever heard of that will do it without needing the framework. Of course, it costs $1249. – Slapout Jan 05 '09 at 20:51
4

I tried a couple of times over the past few years, to get information or evaluation, but they never return my emails about pricing or demos so I think their product may be a bit suspect. – codenheim May 22 '14 at 05:29

thepirat000 · Answer 4 · 2014-10-09T22:18:36.143

20

Microsoft has announced its .NET Native Preview that will allow to run .NET applications without having the framework installed.

Take a look: http://blogs.msdn.com/b/dotnet/archive/2014/04/02/announcing-net-native-preview.aspx

FAQ: http://msdn.microsoft.com/en-US/vstudio/dn642499.aspx

You can download Microsoft .NET Native for VS2013 from here: http://msdn.microsoft.com/en-US/vstudio/dotnetnative

edited Oct 09 '14 at 22:18

answered Apr 03 '14 at 13:17

thepirat000

12,362
4
46
72

score 20 · Answer 5 · answered Sep 05 '08 at 13:02

I have tested several of them and at this moment the only one that supports .NET 3.5 and also has a great virtualization stack is Xenocode Postbuild

With ngen you still need to have the .NET framework installed but using a tool as such all your managed code is compiled into native code so you can deploy it to machines without the framework presence.

Chris Zwiryk · Answer 6 · 2008-09-05T14:39:09.127

11

Yes, using Ngen, the Native Image Generator. There are, however, a number of things you need to be aware of:

You still need the CLR to run your executable.
The CLR will not dynamically optimize your assemblies based on the environment it's run in (e.g. 486 vs. 586 vs. 686, etc.)

All in all, it's only worth using Ngen if you need to reduce the startup time of your application.

edited Sep 05 '08 at 14:39

answered Sep 05 '08 at 12:50

Chris Zwiryk

1,321
9
9

codevision · Answer 7 · 2022-11-11T09:33:30.700

You can use NativeAOT (part of .NET 7, formerly CoreRT).

This technology is a bit limiting, since you cannot rely on reflection too much, but overall you can compile range of application with it. Web apps, WinForms apps, console apps.

As of .NET 7 Preview 5 you can just add

<PropertyGroup>
   <PublishAot>true</PublishAot>
</PropertyGroup>

If you want use daily builds of NativeAOT you need add following lines in your project file

<ItemGroup>
  <PackageReference Include="Microsoft.DotNet.ILCompiler" Version="8.0.0-*" />
</ItemGroup>

and add dotnet8 Nuget feed into your nuget.config like that

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <packageSources>
    <!--To inherit the global NuGet package sources remove the <clear/> line below -->
    <clear />
    <add key="dotnet-public" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-public/nuget/v3/index.json" />
    <add key="dotnet8" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json" />
 </packageSources>
</configuration>

You can target .NET 6 apps, and with ILTrim improvements in .NET 6 the more and more code would be ready for native compilation.

For simple applications you can try use BFlat which may give you even better results.

ILCompiler is now available in nuget feed: https://www.nuget.org/packages/Microsoft.DotNet.ILCompiler/ — M.Hassan, Jun 13 '22 at 17:45

score 9 · Answer 8 · answered Feb 13 '12 at 03:46

You can! However you're restricted to .NET 1.1 (no generics for you): Mono Ahead-Of-Time compilation (AOT)

However, this means compiling is really native, so you'll no longer be able to deploy one single bytecode assembly, you'll need one per platform.

It was originally designed because there's no .NET or Mono for iPhone, so that's how they made MonoTouch.

score 6 · Answer 9 · answered Apr 21 '14 at 01:28

You can do this using the new precompilation technology called .NET Native. Check it out here: http://msdn.microsoft.com/en-US/vstudio/dotnetnative

Currently it is only available for Windows Store Apps. It performs single component linking. So .NET Framework libraries are statically linked into your app. Everything is compiled to native and IL assemblies are no longer deployed. Apps do not run against CLR but a stripped down, optimized runtime called Managed Runtime (Mrt.dll)

As stated above, NGEN used a mix compilation model and relied on IL and JIT for dynamic scenarios. .NET Native does not utilise JIT but it does support various dynamic scenarios. Code authors would need to utilize Runtime Directives to provide hints to the .NET Native compiler on the dynamic scenarios they wish to support.

+1 - I've been waiting years for this to happen. I hoped the world's infatuation with the "Virtual Machine" would run it's course sooner, but nonetheless, it is happening. I expect we are about to see a resurgence of native compilation. As you said, its for Window's Store Apps at the moment, but it is only a matter of time before the desktop market demands equal treatment. — codenheim, May 22 '14 at 05:24

score 5 · Answer 10 · answered Sep 05 '08 at 12:56

5

You can use ngen.exe to generate a native image but you still have to distribute the original non-native code as well, and it still needs the framework installed on the target machine.

Which doesn't solve your problem, really.

answered Sep 05 '08 at 12:56

Matt Bishop

1,487
1
12
19

score 3 · Answer 11 · answered Apr 22 '19 at 15:23

3

2019 Answer: Use dotnet/corert. It can compile .NET Core projects into standalone .exe files. No dependencies (except for system libraries like kernel32.dll). I bet this is exactly what the OP need.

From its GitHub home page:

The CoreRT compiler can compile a managed .NET Core application into a native (architecture specific) single-file executable that is easy to deploy. It can also produce standalone dynamic or static libraries that can be consumed by applications written in other programming languages.

answered Apr 22 '19 at 15:23

kbridge4096

901
1
11
22

The repo is archived & superseded now. – user541686 Dec 09 '20 at 01:03
1

The new repo is called NativeAOT and is at https://github.com/dotnet/runtimelab/tree/feature/NativeAOT – S Waye Jan 31 '21 at 12:44

score 1 · Answer 12 · answered Sep 05 '08 at 13:02

The nature of .NET is to be able to install apps that have been compiled to MSIL, then either by JIT or Ngen, MSIL is compiled to native code and stored locally in a cache. It was never intended on generating a true native .exe that can be run independently of the .NET framework.

Maybe there's some hack that does this, but it doesn't sound safe to me. There are too many dynamics that require the framework, such as: dynamic assembly loading, MSIL code generation, etc.

score 0 · Answer 13 · answered Jul 05 '20 at 18:05

0

The main reason to compile into Native is to secure your codes, otherwise the MSIL compiled is like deploying the source codes in the client's machine.

NGEN compiles into native but also need to deploy IL codes, this purpose is just to reduce the startup time but it is also useless.

CoreRt is alpha version and working only with simple helloworld type apps.

.Net Core compiles into single executable files but it is also not native exe, this is just a zipped file of IL codes and it will unzip the codes into temp folder while running.

My simple question from Microsoft is, if RyuJIT can compile IL into native on the fly then why not you can compile the same IL ahead-of-time (AOT).

answered Jul 05 '20 at 18:05

Rahim Surani

57
3

"CoreRt is alpha version and working only with simple helloworld type apps." This is not true - there are games on Steam (e.g. https://www.streets4rage.com/) which are more complex than helloworld. – S Waye Jul 14 '20 at 17:16
But CoreRT cannot compile any Winform applications. I found another online compiler which can compile Winform application (http://www.dotnetnative.online/) – Rahim Surani Sep 02 '20 at 17:12

score 0 · Answer 14 · answered Oct 04 '20 at 14:34

Looks like net core RT workable solutions; soon all apps will go to .net core; https://www.codeproject.com/Articles/5262251/Generate-Native-Executable-from-NET-Core-3-1-Proje?msg=5753507#xx5753507xx https://learn.microsoft.com/en-us/archive/msdn-magazine/2018/november/net-core-publishing-options-with-net-core

not tested maybe with old win .net sdk possible do similar.

score -2 · Answer 15 · answered Sep 02 '20 at 12:53

-2

try this (http://www.dotnetnative.online/) to compile .net compiled exe into native exe, I tried this, its new but good.

answered Sep 02 '20 at 12:53

Rahim Surani

57
3

Please post the content of the link in the answer. – Russ J Sep 02 '20 at 13:21
@RussJ uh, that's kinda impossible, considering it was a cloud app lol. It's also down, so it's irrelevant as of 2022. – DARKGuy Jan 22 '22 at 01:31

score -3 · Answer 16 · answered Sep 05 '08 at 12:51

-3

I think it's not possible. You will need to distribute .NET FW as well. If you want to compile .NET app to native code, use NGen tool

answered Sep 05 '08 at 12:51

aku

122,288
32
173
203

How to compile a .NET application to native code?

16 Answers16

Linked

Related