Can't install MAUI workload properly on Mac with .NET SDK 8

Paweł Baturo 0

I’m having trouble installing the .NET MAUI workload on my Mac running macOS. Despite trying different versions of the .NET SDK (8.0.401 and 8.0.400), Visual Studio Code consistently fails to detect the installation.

I was removing all .net installations also using recommended tools from documentation, and installing .net SDK again from scratch. Nothing changed the situation. I have been using "dotnet workload repair" , "dotnet workload clean", "dotnet workload restore", "dotnet workload update", nothing seems to work.

Here are the sample logs always ending with same error

Writing workload pack installation record for Microsoft.NETCore.App.Runtime.Mono.maccatalyst-x64 version 7.0.20... Warning: Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found..

When I have SDK 8.0.401 installed, I have had similar error.

I suspect that a previous installation of Visual Studio 2022 (which included .NET 5 and .NET 6) might have left behind some configuration or components that are interfering with the current setup.

Here are the steps

sudo dotnet workload install maui
dotnet workload list

Result: No entries on the list. However when I run

"sudo dotnet workload list"

I see:

Installed Workload Id Manifest Version Installation Source

maui 8.0.72/8.0.100 SDK 8.0.400

On VSCode I have the error on.net maui project (created from template)

".NET MAUI SDK: not found. Please check the .NET MAUI output window for more info."

The output looks:

.NET MAUI Workloads:

Path: /usr/local/share/dotnet Version: 8.0.400

Suggested Workloads to be installed:

Workload: maui-ios

Workload: maui-android

.NET MAUI SDK verification failed. Please try running dotnet workload restore from your project's directory and reopen the solution.

I also get an error from C# dev kit: "Failed to restore solution."

The output looks:

Determining projects to restore...

/usr/local/share/dotnet/sdk/8.0.400/Sdks/Microsoft.NET.Sdk/targets/Microsoft.NET.Sdk.ImportWorkloads.targets(38,5): error NETSDK1147: To build this project, the following workloads must be installed: maui-android [/Users/pbaturo/Repos/dotnet-learning/MauiFirstApplication/MauiFirstApplication/MauiFirstApplication.csproj::TargetFramework=net8.0-android]

/usr/local/share/dotnet/sdk/8.0.400/Sdks/Microsoft.NET.Sdk/targets/Microsoft.NET.Sdk.ImportWorkloads.targets(38,5): error NETSDK1147: To install these workloads, run the following command: dotnet workload restore [/Users/pbaturo/Repos/dotnet-learning/MauiFirstApplication/MauiFirstApplication/MauiFirstApplication.csproj::TargetFramework=net8.0-android]

I have completely no idea why I have this issue.

Can anyone help me with overcoming this, please?

2 answers

Wenyan Zhang (Shanghai Wicresoft Co,.Ltd.) 32,306 Reputation points Microsoft Vendor

2024-09-02T08:33:56.2333333+00:00
Hello,

Suggested Workloads to be installed: Workload: maui-ios Workload: maui-android

From the error message, the workloads are missing.

On macOS, you could run the following command in a terminal to install the maui-android and maui-ios workloads:

sudo dotnet workload install maui-android maui-ios

For more details about installation, please see

Install Visual Studio 2022 and Visual Studio Code to develop cross-platform apps using .NET MAUI - .NET MAUI | Microsoft Learn

Update

Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found

It's a known issue and it was fixed with SDK 8.0.402, please see [NETSDKE2E]With 8.0.400 SDK zip installed, Warning: "Workload garbage collection failed with error: Workload version 8.0.400-baseline.24372.6 was not found.." happens when installing maui workload. · Issue #42358 · dotnet/sdk · GitHub

About how to upgrade to a new .NET version, please see Upgrade to a new .NET version - .NET | Microsoft Learn

Best Regards,

Wenyan Zhang

If the answer is the right solution, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.
Please sign in to rate this answer.
Paweł Baturo 0 Reputation points

2024-09-02T20:18:03.0733333+00:00

Thank you for your answer Zhang

I did what you suggested. After running

sudo dotnet workload install maui-android maui-ios

I have the same error:

Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found..

Below are the last few logs after running this command:

Pack Microsoft.NETCore.App.Runtime.Mono.maccatalyst-x64 version 7.0.20 is already installed. Writing workload pack installation record for Microsoft.NETCore.App.Runtime.Mono.maccatalyst-x64 version 7.0.20... Warning: Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found.

After running the command (without sudo)

dotnet workload list

the list of installed workloads is empty, as it was previously.

I have same errors in VS Code as well

".NET MAUI SDK: not found. Please check the .NET MAUI output window for more info."

and

Determining projects to restore... /usr/local/share/dotnet/sdk/8.0.400/Sdks/Microsoft.NET.Sdk/targets/Microsoft.NET.Sdk.ImportWorkloads.targets(38,5): error NETSDK1147: To build this project, the following workloads must be installed: maui-android [/Users/pbaturo/Repos/dotnet-learning/MauiFirstApplication/MauiFirstApplication/MauiFirstApplication.csproj::TargetFramework=net8.0-android] /usr/local/share/dotnet/sdk/8.0.400/Sdks/Microsoft.NET.Sdk/targets/Microsoft.NET.Sdk.ImportWorkloads.targets(38,5): error NETSDK1147: To install these workloads, run the following command: dotnet workload restore [/Users/pbaturo/Repos/dotnet-learning/MauiFirstApplication/MauiFirstApplication/MauiFirstApplication.csproj::TargetFramework=net8.0-android]"

So unfortunately nothing have changed. Maybe I should look for, for other logs?

Any clue?

Wenyan Zhang (Shanghai Wicresoft Co,.Ltd.) 32,306 Reputation points Microsoft Vendor

2024-09-03T05:31:55.5366667+00:00

It's a known issue and it was fixed with SDK 8.0.402, please see [NETSDKE2E]With 8.0.400 SDK zip installed, Warning: "Workload garbage collection failed with error: Workload version 8.0.400-baseline.24372.6 was not found.." happens when installing maui workload. · Issue #42358 · dotnet/sdk · GitHub

If it doesn't work on your side, please add comments at GitHub to let them know.

About how to upgrade to a new .NET version, please see Upgrade to a new .NET version - .NET | Microsoft Learn

And I update the answer, please view it.

Paweł Baturo 0 Reputation points

2024-09-03T09:35:00.2233333+00:00

Thank you, hope upgrading to new version will help, however. I don't see 8.0.402, on the released SDKs. See: https://dotnet.microsoft.com/en-us/download/dotnet/8.0 The newest one is 8.0.401.

Do you know, by the chance, when 8.0.402, will be available? Or how I could download it?

esra hattab 5 Reputation points

2024-09-04T19:22:32.7833333+00:00

I've been trying to fix this problem the whole day and I'm still stuck, I can't find the Sdk 8.0.402 either since the latest one available is 8.0.401 , hope we'll find away around soon

Wenyan Zhang (Shanghai Wicresoft Co,.Ltd.) 32,306 Reputation points Microsoft Vendor

2024-09-05T09:50:50.0366667+00:00

Please follow the progress at GitHub and wait for updates.
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.
Bruce (SqlWork.com) 66,226 Reputation points

2024-09-03T20:49:34.4133333+00:00

you might want to try workload repair and clean first:

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-repair

once cleaned/repair, try update. should be no errors.

on my Mac, once workloads were messed up (thanks aspire), I finally just deleted all the installed manifests:

%ls /usr/local/share/dotnet/sdk-manifests/

and reinstalled.

location of some other folders you might want to clean:

Dev tools : ~/Library/Developer
Android: ~/Library/Developer/Xamarin/android-sdk-macosx
Java: /Library/Java/JavaVirtualMachines/microsoft-11.jdk/Contents/Home
Dotnet: /usr/local/share/dotnet
Please sign in to rate this answer.
Paweł Baturo 0 Reputation points

2024-09-04T06:28:22.63+00:00

Bruce, thank you for your help.

I think something else is a root cause of my problem. I was following your recommendations. But still have same effects.

dotnet workload list

shows empty list all the time and Visual Code still can't find .NET MAUI.

I will show what I did.

After running

sudo dotnet workload clean

I got

Unhandled exception: System.IO.FileNotFoundException: Workload version 8.0.400-baseline.24375.2 was not found. at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.RefreshWorkloadManifests() at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider..ctor(String sdkRootPath, String sdkVersion, Func`2 getEnvironmentVariable, String userProfileDir, String globalJsonPath, String workloadSetVersion) at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.ForWorkloadSet(String sdkRootPath, String sdkVersion, String userProfileDir, String workloadSetVersion) at Microsoft.DotNet.Workloads.Workload.Install.WorkloadResolverFactory.CreateForWorkloadSet(String dotnetPath, String sdkVersion, String userProfileDir, String workloadSetVersion) at Microsoft.DotNet.Workloads.Workload.Install.WorkloadGarbageCollector.GarbageCollectWorkloadManifestsAndPacks() at Microsoft.DotNet.Workloads.Workload.Install.FileBasedInstaller.GarbageCollect(Func`2 getResolverForWorkloadSet, Nullable`1 offlineCache, Boolean cleanAllPacks) at Microsoft.DotNet.Workloads.Workload.Clean.WorkloadCleanCommand.ExecuteGarbageCollection() at Microsoft.DotNet.Cli.WorkloadCleanCommandParser.<>c.<ConstructCommand>b__3_0(ParseResult parseResult) at System.CommandLine.Invocation.InvocationPipeline.Invoke(ParseResult parseResult) at Microsoft.DotNet.Cli.Program.ProcessArgs(String[] args, TimeSpan startupTime, ITelemetry telemetryClient)

The command

sudo dotnet workload repair

returns the warning (with error message) in the end.

Warning: Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found..

I have removed all in sdk-manifests folder. Interesting fact I have had in the folder 8.0.100 version, but I installed SDK Version: 8.0.400 on my Mac.

I ran

sudo dotnet workload update

I received an error

Workload update failed: Workload not found: macos. Known workloads:

I have installed SDK Version: 8.0.400 and then I am still getting the same error/warning after update attempt.

Warning: Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found..

and I don't see any workloads installed after running.

dotnet workload list

Interesting thing is that when I use sudo to run aforementioned command, then I see

Installed Workload Id Manifest Version Installation Source --------------------------------------------------------------------- macos 14.5.8020/8.0.100 SDK 8.0.400 maui-ios 8.0.72/8.0.100 SDK 8.0.400 maui-android 8.0.72/8.0.100 SDK 8.0.400 maui 8.0.72/8.0.100 SDK 8.0.400

but even running VS Code with elevated privileges doesn't change anything.

Previously I have removed .NET manually and by using a script recommended by Microsoft. So I should start from clean situation. But nothing have changed.

I don't have any idea what is it. I tried with Version: SDK 8.0.401, I ended with exact same issues.

Something is really messed up in my machine. I have suspicion that installation of Visual Studio 2022 (removed a while ago) have something in common with this situation.

Any clue?

Bruce (SqlWork.com) 66,226 Reputation points

2024-09-04T23:39:02.51+00:00

this is a bug introduced with 8.0.400 workload manifests. its basically a warning, but you will need to wait for another release of the workloads to remove the error, or revert to 8.0.300 and its workloads which do not have the bug.

if you can only get the workload list to work with sudo, then the file permissions are not correct and it won't work with vscode unless you start with sudo. you shouldn't have to do this.

I installed 8.0.401 and got the error. I did a clean and reinstall, which still has the error, but workloads still list without sudo.

% dotnet workload list Installed Workload Id Manifest Version Installation Source --------------------------------------------------------------------- macos 14.5.8020/8.0.100 SDK 8.0.400 maui-ios 8.0.72/8.0.100 SDK 8.0.400 ios 17.5.8020/8.0.100 SDK 8.0.400

then I used vscode to create a maui project. edited the project to be iOS only (only maui workload I installed). then restore. selected an xmal file, and set target and startup, then debug (see maui extension docs). app started right up.

note: the workloads are only tied to the major/minor version, not the patch, are supported separately.

Paweł Baturo 0 Reputation points

2024-09-05T15:44:15.24+00:00

I revert to SDK version 8.0.304, and indeed, I don't have the error/warning "Warning: Workload garbage collection failed with error: Workload version 8.0.400-baseline.24375.2 was not found.." anymore.

I installed workloads "macos, maui-ios, ios", but

dotnet workload list

still shows empty list.

You mentioned that it could be something wrong with the file permissions. Could you tell me please what files should I look like and what permissions are correct?

By the way, running VS Code with elevated privileges didn't change the situation I still have an error ".NET MAUI SDK: not found" and C# dev kit: "Failed to restore solution".

Wenyan Zhang (Shanghai Wicresoft Co,.Ltd.) 32,306 Reputation points Microsoft Vendor

2024-09-13T07:14:30.21+00:00

Do you still have the problem?
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.

Share via

Can't install MAUI workload properly on Mac with .NET SDK 8

2 answers

Your answer