Installation instructions for .NET 8 Preview 1 and .NET MAUI

net-maui-8-preview.1.md

These instructions are also on this MS internal loop.

.NET SDK

For now, use a specific build of the .NET SDK:

• Windows: https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-preview.1.23109.10/dotnet-sdk-8.0.100-preview.1.23109.10-win-x64.exe
• Apple M1: https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-preview.1.23109.10/dotnet-sdk-8.0.100-preview.1.23109.10-osx-arm64.pkg
• Apple Intel: https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-preview.1.23109.10/dotnet-sdk-8.0.100-preview.1.23109.10-osx-x64.pkg

Future builds of .NET 8 Preview 1 are here:

https://github.com/dotnet/installer

The column named 8.0.1xx-preview1.

.NET MAUI

Install MAUI via:

dotnet workload install maui --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json --source https://api.nuget.org/v3/index.json --from-rollback-file https://maui.blob.core.windows.net/metadata/rollbacks/9567bfa68859d611cc9aad2555fd9847f8233cda.json --verbosity diag

NOTE: use sudo if appropriate on macOS.

Add the .NET 8 nightly feed, you can use a nuget.config or add to the global one via:

dotnet nuget add source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json --name dotnet8

Known Issues

On Windows non-domain joined machines, you may get the error:

Installation failed: The SDDL string contains an invalid sid or a sid that cannot be translated. (Parameter 'sddlForm')

To workaround, you can disable .msi-based workload installs by deleting the file at any of these locations:

C:\Program Files\dotnet\metadata\workloads\8.0.100\installertype\msi
C:\Program Files\dotnet\metadata\workloads\8.0.100-preview.1\installertype\msi

This might be addressed by the time .NET 8 Preview 1 ships.

On win-arm64 machines, you might get the error:

Workload ID maui isn't supported on this platform.

The only workaround for preview 1 is to manually patch WorkloadManifest.json files as mentioned here.

On macOS, if you encounter a build error related to mono-aot-cross:

An error occurred trying to start process '/usr/local/share/dotnet/packs/Microsoft.NETCore.App.Runtime.AOT.osx-x64.Cross.maccatalyst-x64/8.0.0-preview.1.23106.5/Sdk/../tools/mono-aot-cross'. Permission denied

You can workaround the issue, by making the file executable:

chmod +x /usr/local/share/dotnet/packs/Microsoft.NETCore.App.Runtime.AOT.osx-x64.Cross.maccatalyst-x64/8.0.0-preview.1.23106.5/tools/mono-aot-cross

This is tracked in dotnet/runtime#82201.

Recommended versions of things

Xcode 14.2
Android 33
WinAppSDK?