Troubleshooting Uno Check
If you run into problems with uno-check, you should generally try the following:
Update the tool to the latest version:
dotnet tool update -g uno.check --add-source https://api.nuget.org/v3/index.json
If you are running with .NET 9+, and workloads are causing issues (e.g. missing workloads even when everything seems installed), try running the following command:
dotnet workload clean --all
This command will clean all workloads for all installed .NET versions. This will allow uno-check
to reinstall them properly.
If the dotnet workload clean
tells that some workloads can't be removed, try using the repair
command in the Visual Studio installer as well.
If you encounter build errors such as:
error MSB4022: The result "" of evaluating the value "$(MonoTargetsTasksAssemblyPath)" of the "AssemblyFile" attribute in element <UsingTask> is not valid.
, it may help to run the following command:dotnet workload repair
This can resolve issues where uno-check does not surface any problems but builds still fail.
- Run with
uno-check --force-dotnet
to ensure the workload repair/update/install commands run regardless of if uno-check thinks the workload versions look good. - If you encounter the error
Unable to load the service index
when installinguno-check
for a host name not ending bynuget.org
, try using the--ignore-failed-sources
parameter. - If you still have errors, it may help to run the Clean-Old-DotNet6-Previews.ps1 script to remove old SDK Packs, templates, or otherwise old cached preview files that might be causing the problem. Try running
uno-check --force-dotnet
again after this step. - If you encounter the message
There were one or more problems detected. Please review the errors and correct them and run uno-check again.
, but if you have done all the previously mentioned steps, try running it with--verbose
flag to see where it is failing. - Finally, if you have other problems, run also with
--verbose
flag and capture the output and add it to a new issue.