jonathanpeppers/net-maui-8-preview.1.md

## net-maui-8-preview.1.md

      
    Raw
  

              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.