.NET Runtime - Native AOT

This branch contains experimental fork of CoreCLR .NET runtime optimized for the Native AOT Form factor. The ahead-of-time (AOT) toolchain can compile .NET application into a native (architecture specific) single-file executable. It can also produce standalone dynamic or static libraries that can be consumed by applications written in other programming languages.

Samples

The packages for Linux, macOS and Windows x64 are published to a dedicated NuGet feed after each pull request. Using this AOT compiler and runtime is as simple as adding a new package reference to your .NET project and publishing it. Check out one of our samples: a "Hello World" console app or a native library. The README.md file in each sample's directory will guide you through the process step by step.

Documentation

• Using Native AOT explains how to debug, optimize and troubleshoot applications published using the native AOT toolchain. This documentation is for people who are interested in using the toolchain.
• Developer workflow explains how to build the repo, run tests and work on the Native AOT toolchain. This documentation is for people who are interested in making changes in the toolchain.

How to Engage, Contribute and Provide Feedback

Some of the best ways to contribute are to try things out, file bugs, and join in design conversations.

Looking for something to work on? The help wanted issues are a great place to start.

This project is successor of RyuJIT CodeGen from CoreRT where you can find more samples and older documentation.

.NET Runtime

This repo contains the code to build the .NET runtime, libraries and shared host (dotnet) installers for all supported platforms, as well as the sources to .NET runtime and libraries.

What is .NET?

Official Starting Page: https://dotnet.microsoft.com/

• How to use .NET (with VS, VS Code, command-line CLI)
  • Install official releases
  • Install daily builds
  • Documentation (Get Started, Tutorials, Porting from .NET Framework, API reference, ...)
  • Deploying apps
  • Supported OS versions
• Roadmap
• Releases

How can I contribute?

We welcome contributions! Many people all over the world have helped make this project better.

• Contributing explains what kinds of contributions we welcome
• Workflow Instructions explains how to build and test
• Get Up and Running on .NET Core explains how to get nightly builds of the runtime and its libraries to test them in your own projects.

Reporting security issues and security bugs

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Also see info about related Microsoft .NET Core and ASP.NET Core Bug Bounty Program.

Filing issues

This repo should contain issues that are tied to the runtime, the class libraries and frameworks, the installation of the dotnet binary (sometimes known as the muxer) and installation of the .NET runtime and libraries.

For other issues, please use the following repos:

• For overall .NET SDK issues, file in the dotnet/sdk repo
• For ASP.NET issues, file in the dotnet/aspnetcore repo.

Useful Links

• .NET Core source index / .NET Framework source index
• API Reference docs
• .NET API Catalog (incl. APIs from daily builds and API usage info)
• API docs writing guidelines - useful when writing /// comments
• .NET Discord Server - a place to talk and hang out with .NET community

.NET Foundation

.NET Runtime is a .NET Foundation project.

There are many .NET related projects on GitHub.

• .NET home repo - links to 100s of .NET projects, from Microsoft and the community.
• ASP.NET Core home - the best place to start learning about ASP.NET Core.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

General .NET OSS discussions: .NET Foundation forums

License

.NET (including the runtime repo) is licensed under the MIT license.