Announcing .NET 6 Release Candidate 1
We are happy to release .NET 6 Release Candidate 1. It is the first of two “go live” release candidate releases that are supported in production. For the last month or so, the team has been focused exclusively on quality improvements that resolve functional or performance issues in new features or regressions in existing ones.
You can download .NET 6 Release Candidate 1 for Linux, macOS, and Windows.
- Installers and binaries
- Container images
- Linux packages
- Release notes
- API diff
- Known issues
- GitHub issue tracker
See the .NET MAUI and ASP.NET Core posts for more detail on what’s new for client and web application scenarios.
We’re at that fun part of the cycle where we support the new release in production. We genuinely encourage it. In the last post, I suggested that folks email us at email@example.com to ask for guidance on how to approach that. A bunch of businesses reached out wanting to explore what they should do. The offer is still open. We’d love to hit two or three dozen early adopters and are happy to help you through the process. It’s pretty straightforward.
.NET 6 RC1 has been tested and is supported with Visual Studio 2022 Preview 4. Visual Studio 2022 enables you to leverage the Visual Studio tools developed for .NET 6 such as development in .NET MAUI, Hot Reload for C# apps, new Web Live Preview for WebForms, and other performance improvements in your IDE experience.
Support for .NET 6 RC1 is coming soon in Visual Studio 2022 for Mac Preview 1, which is currently available as a private preview.
Check out the new conversations posts for in-depth engineer-to-engineer discussions on the latest .NET features.
The rest of the post is dedicated to foundational features in .NET 6. In each release, we take on a few projects that take multiple years to complete and that (by definition) do not deliver their full value for some time. Given that these features have not come to their full fruition, you’ll notice a bias in this post to what we’re likely to do with these features in .NET 7 and beyond.
Source build is a scenario and also infrastructure that we’ve been working on in collaboration with Red Hat since before shipping .NET Core 1.0. Several years later, we’re very close to delivering a fully automated version of it. For Red Hat Enterprise Linux (RHEL) .NET users, this capability is a big deal. Red Hat tells us that .NET has grown to become an important developer platform for their ecosystem. Nice!
Clearly, .NET source code can be built into binaries. Developers do that every day after cloning a repo from the dotnet org. That’s not really what this is about.
The gold standard for Linux distros is to build open source code using compilers and toolchains that are part of the distro archive. That works for the .NET runtime (written in C++), but not for any of the code written in C#. For C# code, we use a two-pass build mechanism to satisfy distro requirements. It’s a bit complicated, but it’s important to understand the flow.
Red Hat builds .NET SDK source using the Microsoft build of the .NET SDK (#1) to produce a pure open source build of the SDK (#2). After that, the same SDK source code is built again using this fresh build of the SDK (#2) to produce a provably open source SDK (#3). This final SDK (#3) is then made available to RHEL users. After that, Red Hat can use this same SDK (#3) to build new .NET versions and no longer needs to use the Microsoft SDK to build monthly updates.
That process may be surprising and confusing. Open source distros need to be built by open source tools. This pattern ensures that the Microsoft build of the SDK isn’t required, either by intention or accident. There is a higher bar, as a developer platform, to being included in a distro than just using a compatible license. The source build project has enabled .NET to meet that bar.
The deliverable for source build is a source tarball. The source tarball contains all the source for the SDK (for a given release). From there, Red Hat (or another organization) can build their own version of the SDK. Red Hat policy requires using a built from source toolchain to produce a binary tar ball, which is why they use a two-pass methodology. But this two-pass method is not required for source build itself.
It is common in the Linux ecosystem to have both source and binary packages or tarballs available for a given component. We already had binary tarballs available and now have source tarballs as well. That makes .NET match the standard component pattern.
The big improvement in .NET 6 is that the source tarball is a now a product of our build. It used to require significant manual effort to produce, which also resulted in significant latency delivering the source tarball to Red Hat. Neither party was happy about that.
We’ve been working closely with Red Hat on this project for five+ years. It has succeeded, in no small part, due to the efforts of the excellent Red Hat engineers we’ve had the pleasure of working with. Other distros and organizations will benefit from their efforts.
As a side note, source build is a big step towards reproducible builds, which we also strongly believe in. The .NET SDK and C# compiler have significant reproducible build capabilities. There are some specific technical issues that still need to be resolved for full reproducibility. Surprisingly, a major remaining issue is using stable compression algorithms for compressed content in assemblies.
Profile-guided optimization (PGO)
Profile Guided Optimization (PGO) is an important capability of most developer platforms. It is based on the assumption that the code executed as part of startup is often uniform and that higher-level performance can be delivered by exploiting that.
There are lots of things you can do with PGO, such as:
- Compile startup code at higher-quality.
- Reduce binary size by compiling low-use code at lower-quality (or not at all).
- Re-arrange application binaries such that code used at startup is co-located near the start of the file.
.NET has used PGO in various forms for twenty years. The system we initially developed was both proprietary and (very) difficult to use. It was so difficult to use that very few other teams at Microsoft used it even though it could have provided significant benefit. With .NET 6, we decided to rebuild the PGO system from scratch. This was motivated in large part by crossgen2 as the new enabling technology.
There are several aspects to enabling a world-class PGO system (at least in our view):
- Easy-to-use training tools that collect PGO data from applications, on the developer desktop and/or in production.
- Straightforward integration of PGO data in the application and library build flow.
- Tools that process PGO data in various ways (differencing and transforming).
- Human- and source-control-friendly text format for PGO data.
- Static PGO data can be used by a dynamic PGO system to establish initial insight.
In .NET 6, we focused on building the foundation that can enable those and other experiences. In this release, we just got back to what we had before. The runtime libraries are compiled to ready-to-run format optimized with (the new form of) PGO data. This is all enabled with crossgen2. At present, we haven’t enabled anyone else to use PGO to optimize apps. That’s what will be coming next with .NET 7.
Dynamic PGO is the mirror image of the static PGO system I just described. Where static PGO is integrated with crossgen2, dynamic PGO is integrated with RyuJIT. Where static PGO requires a separate training activity and using special tools, dynamic PGO is automatic and uses the running application to collect relevant data. Where static PGO data is persisted, dynamic PGO data is lost after every application run. Dynamic PGO is similar to a tracing JIT.
Dynamic PGO is currently opt-in, with the following environment variables set.
The Performance Improvements in .NET 6 post does a great job of demonstrating how dynamic PGO improves performance.
Tiered compilation (TC) has similar characteristics to dynamic PGO. In fact, dynamic PGO can be thought of as tiered compilation v2. TC provides a lot of benefit, but is unsophisticated in multiple dimensions and can be greatly improved. It’s brains for a scarecrow.
Perhaps the most interesting capability of dynamic PGO is devirtualization. The cost of method calls can be described like this: interface > non-interface virtual > non-virtual. If we can transform an interface method call into a non-virtual call, then that’s a significant performance improvement. That’s super hard in the general case, since it is very difficult to know statically which classes implement a given interface. If it is done wrong, the program will (hopefully) crash. Dynamic PGO can do this correctly and efficiently.
RyuJIT can now generate code using the “guarded devirtualization” compiler pattern. I’ll explain how that works. Dynamic PGO collects data on the actual classes that satisfy an interface in some part of a method signature at runtime. If there is a strong bias to one class, it can tell RyuJIT to generate code that prefers that class and use direct method calls in terms of that specific class. As suggested, direct calls are much faster. If, in the unexpected case, that the object is of a different class, then execution will jump to slower code that uses interface dispatch. This pattern preserves correctness, isn’t much slower in the unexpected case, and is much faster in the expected typical case. This dual-mode system is called guarded since the faster devirtualized code is only executed after a successful type check.
There are other capabilities that we can imagine implementing. For example, some combination of Crossgen2 and Dynamic PGO can learn how to sparsely compile methods based on usage (don’t initially compile rarely taken if/else blocks). Another idea is that Crossgen2 can communicate (via some weighting) which methods are most likely to benefit from higher tiers of compilation at runtime.
I’ve discussed crossgen2 multiple times now, both in this post and previously. Crossgen2 is a major step forward for ahead-of-time or pre-compilation for the platform. There are several aspects to this that lay the foundation for future investments and capabilities. It’s non-obvious but crossgen2 may be the most promising foundational feature of the release. I’ll try to explain why I’m so excited about it.
The most important aspect is that crossgen2 has a design goal of being a standalone compiler. Crossgen1 was a separate build of the runtime with just the components required to enable code generation. That approach was a giant hack and problematic for a dozen different reasons. It got the job done, but that’s it.
Similarly, the standalone nature enables it to be cross-targeting. It can, for example, target ARM64 from x64, Linux from Windows, or .NET 6 from .NET 7.
I’ll cover a few of the scenarios that we’re immediately interested in enabling, after .NET 6. From here on, I’ll just use “crossgen”, but I mean “crossgen2”.
By default, ready-to-run (R2R) code has the same version-ability as IL. That’s objectively the right default. If you are not sure what the implications of that are, that’s demonstrating we chose the right default. In .NET 6, we added a new mode that extends the version boundary from a single assembly to a group of assemblies. We call that a “version bubble”. There are two primary capabilities that version bubbles enable: inlining of methods and cross-assembly generic instantiations (like
string were in different assemblies). The former enables us to generate higher-quality code and the latter enables actually generating R2R code where we otherwise have to rely on the JIT. This feature delivers double-digit startup benefits in our tests. The only downside is that version bubbles typically generate more code as a result. That’s where the next capability can help.
Today, crossgen generates R2R code for all methods in an assembly, including the runtime and SDK. That’s very wasteful since probably at least half of them would be best left for jitting at runtime (if they are needed at all). Crossgen has had the capability for partial compilation for a long time, and we’ve even used it. In .NET Core 3.0, we used it to remove about 10MB from the runtime distribution on Linux. Sadly, that configuration got lost at some point and we’re now carrying that extra 10MB around. For .NET 7, we’re going to take another crack at this, and will hopefully identify a lot more than 10MB of R2R code to no longer generate (which naturally has benefits beyond just size reduction).
Vector or SIMD instructions are significantly exploited in .NET libraries and are critical to delivering high performance. By default, crossgen uses an old version (SSE2) of these instructions and relies on tiered compilation to generate the best SIMD instructions for a given machine. That works but isn’t optimal for modern hardware (like in the cloud) and is particularly problematic for short-running serverless applications. Crossgen enables specifying a modern and better SIMD instruction set like AVX2 (for Intel and AMD). We plan to switch to producing ready-to-run images for AVX2 with this new capability for .NET 7. This capability isn’t currently relevant for Arm64 hardware, with NEON being universally and the best instructions available. When SVE and SVE2 become common place, we’ll need to deploy a similar model for Arm64.
Whatever is the most optimal crossgen configuration, that’s how we’ll deliver container images. We see containers as our most legacy-free distribution type and want to better exploit that. We see lots of opportunity for “fully optimized by default” for containers.
We published a security roadmap earlier this year to provide more insight on how we are approaching industry standard security techniques and hardware features. The roadmap is also intended to be a conversation, particularly if you’ve got a viewpoint you want to share on these topics.
We added preview support for two key security mitigations this release: CET, and W^X. We intend to enable them by default in .NET 7.
Intel’s Control-flow Enforcement Technology (CET) is a security feature available in some newer Intel and AMD processors. It adds capabilities to the hardware that protect against some common types of attacks involving control-flow hijacking. With CET shadow stacks, the processor and operating system can track the control flow of calls and returns in a thread in the shadow stack in addition to the data stack, and detect unintended changes to the control flow. The shadow stack is protected from application code memory accesses and helps to defend against attacks involving return-oriented programming (ROP).
See .NET 6 compatibility with Intel CET shadow stacks (early preview on Windows) for more details and instructions on enabling CET.
W^X is one of the most fundamental mitigations. It blocks the simplest attack path by disallowing memory pages to be writeable and executable at the same time. The lack of this mitigation has resulted in us not considering more advanced mitigations, since they could be bypassed by the lack of this capability. With W^X in place, we will be adding other complementary mitigations, like CET.
Apple has made the W^X mandatory for future versions of macOS desktop operating system as part of Apple Silicon transition. It motivated us to schedule implementation of this mitigation for .NET 6, on all supported operating systems. Our principle is to treat all supported operating systems equally with respect to security, where possible. W^X is available all operating systems with .NET 6 but only enabled by default on Apple Silicon. It will be enabled on all operating systems for .NET 7.
HTTP/3 is a new HTTP version. It is in preview with .NET 6. HTTP/3 solves existing functional and performance challenges with past HTTP versions by using a new underlying connection protocol called QUIC. QUIC uses UDP and has TLS built in, so it’s faster to establish connections as the TLS handshake occurs as part of the connection. Each frame of data is independently encrypted so the protocol no longer has the head of line blocking challenge in the case of packet loss. Unlike TCP a QUIC connection is independent of the IP address, so mobile clients can roam between wifi and cellular networks, keeping the same logical connection, and can continuing long downloads.
At the current time, the RFC for HTTP/3 is not yet finalized, and so can still change. We have included HTTP/3 in .NET 6 so that you can start experimenting with it. It is a preview feature, and so is unsupported. There may be rough edges, and there needs to be broader testing with other servers & clients to ensure compatibility.
.NET 6 does not include support for HTTP/3 on macOS, primarily because of a lack of a QUIC-compatible TLS API. .NET uses SecureTransport on MacOS for its TLS implementation, which does not yet include TLS APIs to support QUIC handshake.
A deep-dive blog post on HTTP/3 in .NET 6 will soon be published.
SDK workloads is a new capability that enables us to add new major capabilities to .NET without growing the SDK. That’s what we’ve done for .NET MAUI, Android, iOS, and WebAssembly. We haven’t measured all of the new workloads together, but it’s easy to guess that they would sum to at least the size of the SDK as-is. Without workloads, you’d probably be unhappy about the size of the SDK.
In future releases, we intend to remove more components and make them optional, including ASP.NET and the Windows Desktop. In the end, one can imagine the SDK containing only MSBuild, NuGet, the language compilers and workload acquisition functionality. We very much want to cater to a broad .NET ecosystem and to deliver just the software you need to get your particular job done. You can see how this model would be much better for CI scenarios, enabling dotnet tools to acquire a bespoke set of components for the specific code being built.
We’re coming to the end of the release. We thought we’d take a few moments to showcase some community contributors who have been significant contributions. We covered two contributors in the .NET 6 Preview 7 post and want to highlight another in this post.
The text is written in the contributor’s own words.
Theodore Tsirpanis (@teo-tsirpanis)
My name is Theodore Tsirpanis, and I am from Thessaloniki, Greece. In less than a month, I will begin my senior (fourth and final) year as an undergraduate student at the Department of Applied Informatics of the University of Macedonia. Besides maintaining some projects of my own (mostly developer-facing tools and libraries), I have been contributing to various open-source projects on GitHub for quite some time. What I like the most about open-source is that the soonest you find a bug or a performance improvement opportunity, you can very quickly act upon it yourself.
My journey with .NET also started quite some time ago. My first programming language was Pascal but it didn’t take too long to discover C# and later F#, and marvel at the sheer amount of technological artisanship that permeates the .NET ecosystem. I am always eager to read a new blog post and spend more time than I remember randomly strolling around the libraries’ source code using ILSpy, improving my coding skills in the process. My enjoyment of writing highly performant code, and the impact of contributing to such a large project is what motivated me to contribute to the .NET libraries. The team members are very responsive and have the same passion for code quality and performance as I do. I am very glad to have played a part in making .NET a great piece of software, and I look forward to contributing even more in the future.
.NET 6 has a lot of new features and capabilities that are for the here-and-now, most of which have been explored in all the previews and also in the upcoming .NET 6 posts. At the same time, it’s inspiring to see the new features in .NET 6 that will lay the foundation for what’s coming next. These are big-bet features that will push the platform forward in both obvious and non-obvious ways.
For the first several releases, the team needed to focus on establishing .NET Core as a functional and holistic open source and cross-platform development system. Next, we focused on unifying the platform with Xamarin and Mono. You can see that we’re departing from that style of project to more forward-looking ones. It’s great to see the platform again expand in terms of fundamental runtime capabilities, and there’s much more to come along those lines.
Thanks for being a .NET developer.
Did you change the way we enable preview features in this release as some Generic Math code I wrote no longer compiles? The System.Runtime.Experimental package no longer exists.
Any chance you can post the errors you are seeing? I just turned the
CA2252analyzer severity up to
Error, so you may be running into that. We don’t have the docs page for CA2252 up yet, so please feel free to open an issue in dotnet/roslyn-analyzers and tag me (pgovind) if this is what you’re running into.
Never mind, it’s working now. Thanks
I’m getting CA2252 errors on apps that worked previously.
Are these errors specifically on code using
static abstracts in interfacesor
Or are these errors in other code, such as code that was working in .NET 5, for example?
Created issue here.
Will .NET 6 RTM at around the same date as VS 2022 in November? Since it seems it’s required in order to use it.
I don’t know what the VS team has shared publicly, but I don’t believe we can technically ship separately so I assume there will be VS 2022 release on .NET 6 RTM day. I don’t know is the VS release will be final or still a preview.
Nice info as always.
But why newer verisons of .Net are supported only in newest edition of Visual Studio? Why users of a little older editions cannot use it in this editions? What does it have, that it cannot be supported?
This is confusing to me as well. The post says “.NET 6 RC1 has been tested and is supported with Visual Studio 2022 Preview 4,” but it does not say it’s “only supported in Visual Studio 2022 Preview 4.” @Richard, can you please tell us what versions of VS support .NET 6 RC 1?
Microsoft team again and again says that VS 2019 16.11.x is not supported (but FYI you can still build and debug .NET 6.0-rc1 applications (at least console, WinForms and WPF) – just enable preview SDKs in VS2019 settings and manually set TFM in .csproj file). You can upvote there on Github issue page or on a developercommunity topic.
.NET 6 is only supported in VS 2022. There are lots of changes and both big and small integrations that we put into Visual Studio to make it work well with a new .NET version. We focus exclusively on that and do not even test .NET 6 in VS 2019. This approach helps us focus our efforts and enables us to tell a simple story. If we supported VS 2019, there would undoubtably be a lot of caveats on what worked well and what doesn’t. Some people would be OK with that, but we expect most people would be dissatisfied.
IIRC there were statements in the past which say that VS2019 can use new frameworks in the future. 🙁
I am using .net 6 and Blazor from preview 5 or 6 and Visual Studio 2022 from preview 2. Last night I upgraded from preview 7 to RC1. One of packages, although upgraded to RC1, is not working. It is database provider and I am basically cut of from my db 🙂 I submitted a bug report but since it is community project I cannot be sure when will it be fixed.
How can I download .net 6 preview 7 to revert to previous state of things? Can I keep using VS 2022 preview 4 with .net preview 7 or I would have to install VS preview 3?
You would probably need to move to Preview 3.
Send me the report at firstname.lastname@example.org.
I’ve sent an email last week citing your comment. No reply.
Great news, can’t wait until we can use it in production.
One comment: Regarding the environment variables. Can you make them please also available in the runtimeconfig.json. We are creating standalone non-installable application. I’m currently having the same problem with GCCpuGroup. It was a config property in .NET Framework, but when switching to .NET Core it became a environment variable (COMPlus_Thread_UseAllCpuGroup, in .NET 6 now: DOTNET_Thread_UseAllCpuGroup ). While this is OK for debugging, it is hard to handle when distributing applications where you know in advance what you want to configure. I would suggest in general having the MSBuild/Environment/runtimeconfig.json options as given in https://docs.microsoft.com/en-us/dotnet/core/run-time-config/. For some reason though, properties are not available in one or the other.
Agreed. Have you looked at runtime config templates?
Thanks for the answer. Yes I did, but only DOTNET_TC_QuickJitForLoops which has a corresponding setting for the runtimeconfig.json, but DOTNET_TieredPGO is missing. I assume it’s currently not officially documented, right? Nevertheless, I still stand by my request that there needs to be a runtimeconfig.json counterpart for all settings 😉
I have a problem when i try to update a RC:
dotnet workload install maui
Downloading microsoft.net.sdk.ios.manifest-6.0.100.msi.x64 (15.0.100-rc.1.1531)
Installation rollback failed: One or more errors occurred. (microsoft.net.sdk.ios.manifest-6.0.100.msi.x64::15.0.100-rc.1.1531 is not found in NuGet feeds https://api.nuget.org/v3/index.json;https://pkgs.dev.azure.com/dnceng/public/_packaging/6.0.100-rc.1.21458.32-shipping/nuget/v3/index.json“.)
Workload update failed: One or more errors occurred. (microsoft.ios.sdk.msi.x64::15.0.100-rc.1.1531 is not found in NuGet feeds https://api.nuget.org/v3/index.json;https://pkgs.dev.azure.com/dnceng/public/_packaging/6.0.100-rc.1.21458.32-shipping/nuget/v3/index.json“.)
Is C# 10 latest coming with this .NET 6 RC1?
I’m highly anticipating the new field keyword.
Should be. I plan to talk about C# 10 in the RC2 post.
I was using VS2022 Preview 3.1 for a Blazor app, and deploying to Azure Service App. Today, the deployment started failing without any code modification.
This was due to the Build Engine version being upgraded and the Implicit Using feature which seems to have been switched off by default in that new version.
I had to modify my projects to add:
Also, compiling and deploying the app through Azure with the latest version of the Build Engine (Microsoft (R) Build Engine version 17.0.0-preview-21458-01+2c5510013 for .NET), it triggered an HTTP 500.31 error for every page of the app.
I had to force the build pipeline to use .Net Core 6.0.100-preview.7.21379.14 to build my app in order for it to work.
Are there some settings to change on Azure to have the app work with the latest version of the Build Engine?
I had to figure out it too. But I guess the change makes sense for now. ImplicitUsings enabled by default would cause problems for existing projects as people have pointed out. Creating a new project made me understand what was missing. After that I just had to add the property to all of my projects.
Is it possible to define DOTNET_TieredPGO and DOTNET_TC_QuickJitForLoops in appsettings ?
Not yet. Good question.
This is the best we have currently: https://docs.microsoft.com/dotnet/core/run-time-config/compilation. We’ll make this feature first-class in .NET 7.
“Thanks for being a .NET developer.”
Well thanks for making us proud to be .NET developers! You guys are rocking it, we get to bask in these improvements (and by the way guys, maybe a little price for that is paying up for newer VS versions occasionally, just a thought eh). I agree with Tzirpanis when he said that he: “marvels at the sheer amount of technological artisanship that permeates the .NET ecosystem,” as these posts demonstrate well. Cheers