.NET 8.0 Preview 1 release - .NET 8.0.0-preview.1 and SDK 8.0.100-preview.1

announcement.md

Title: .NET 8.0 Preview 1 release - .NET 8.0.0-preview.1 and SDK 8.0.100-preview.1

Please use the v8.0.100-preview.1 tag to source-build .NET version 8.0.0-preview.1 / 8.0.100-preview.1.

• Release Notes: https://github.com/dotnet/core/blob/main/release-notes/8.0/preview/8.0.0-preview.1.md
• Tag URL: https://github.com/dotnet/dotnet/releases/tag/v8.0.100-preview.1

Virtual Mono Repository (VMR)

.NET is now buildable on Linux directly from the dotnet/dotnet repository. We're calling this new repository a Virtual Mono Repository (VMR). It has the benefits of a true monorepo but is a regularly-updated projection of the many existing repos that contributors work in (more efficiently) every day. We see this new approach as being a significant step forward in approachability for building .NET as a whole product from source.

See build instructions to build the VMR on your own machine.

Prebuilts

This release requires the following prebuilts. These prebuilts are retrieved by prep.sh in order to support building in an offline environment.

• Microsoft.AspNetCore.App.Ref.6.0.13
• Microsoft.AspNetCore.App.Ref.7.0.2
• Microsoft.AspNetCore.App.Runtime.osx-x64.7.0.2
• Microsoft.AspNetCore.App.Runtime.win-x64.7.0.2
• Microsoft.AspNetCore.App.Runtime.win-x86.7.0.2
• Microsoft.NET.ILLink.Tasks.7.0.100-1.23062.2
• Microsoft.NETCore.App.Host.linux-x64.7.0.2
• Microsoft.NETCore.App.Host.osx-x64.7.0.2
• Microsoft.NETCore.App.Host.win-x64.7.0.2
• Microsoft.NETCore.App.Host.win-x86.7.0.2
• Microsoft.NETCore.App.Ref.6.0.13
• Microsoft.NETCore.App.Ref.7.0.2
• Microsoft.NETCore.App.Runtime.osx-x64.7.0.2
• Microsoft.NETCore.App.Runtime.win-x64.7.0.2
• Microsoft.NETCore.App.Runtime.win-x86.7.0.2
• Microsoft.NETFramework.ReferenceAssemblies.1.0.3
• Microsoft.NETFramework.ReferenceAssemblies.net20.1.0.3
• Microsoft.NETFramework.ReferenceAssemblies.net45.1.0.3
• Microsoft.NETFramework.ReferenceAssemblies.net452.1.0.3
• Microsoft.NETFramework.ReferenceAssemblies.net462.1.0.3
• Microsoft.NETFramework.ReferenceAssemblies.net472.1.0.3
• Microsoft.NETFramework.ReferenceAssemblies.net48.1.0.3

Bootstrapping

Each major release of .NET requires bootstrapping. Because of the previously mentioned prebuilts, the stage 2 build (e.g. rebuilding) requires the following RID-specific prebuilt. This needs to be retrieved from your 7.0.2 source-built artifacts. If you haven't source-built 7.0.2 you won't be able to bootstrap 8.0 preview 1. This prebuilt is not required when building stage 1 (e.g. building with the Microsoft provided SDK). Place this package into the directory specified by the build.sh --with-packages option.

• Microsoft.NETCore.App.Host.<RID>.7.0.2

@dotnet/distro-maintainers

{
  "Channel": "8.0",
  "Runtime": "8.0.0-preview.1",
  "Sdk": "8.0.100-preview.1",
  "DotnetTag": "v8.0.100-preview.1"
}

Thanks @richlander - I changed the wording as suggested

• work in (more efficiently) ever day -> every day
• Do we want to clarify that "does not build cleanly" is just prebuilts? I think for some that might mean "with errors or warnings".
• e.g. rebuilding with the source-built SDK -> i.e. rebuilding
• rid specific -> think we're more consistently "RID-specific" in the docs
• We should clarify that it's not always fedora36, it's the RID that you're building on, right?

Thanks @crummel - I addressed all of your points.

Every day, I feel like errors and warnings stop me from re-building RID-specific apps on Fedora 36, right?

The link that points to the VMR epic could also point to the VMR announcement which maybe gives more context for people new to the topic - dotnet/arcade#11584

"This needs to be retrieved from a 7.0.2 source-build environment" -> could you clarify on how to get that package? Do I need to reference a specific feed or is it available to be downloaded from somewhere? Thanks

@richlander it just occurred to me - should we link into the VMR tag (https://github.com/dotnet/dotnet/releases/tag/v8.0.0-preview.1) from the blog post where we talk about the VMR?

The link that points to the VMR epic could also point to the VMR announcement which maybe gives more context for people new to the topic - dotnet/arcade#11584

@premun - fixed as suggested.

"This needs to be retrieved from a 7.0.2 source-build environment" -> could you clarify on how to get that package? Do I need to reference a specific feed or is it available to be downloaded from somewhere? Thanks

@tkapin - addressed.