升级 dotnet 版本后 MAUI 项目配对失败的解决方案

每次在 Windows 中升级了 Visual Studio 2022 或者升级了 dotnet sdk 到新版本之后,再次打开 MAUI 项目进行配对的时候,Visual Studio 2022 就会使用 dotnet-install 脚本在 macOS 中安装新版本 dotnet sdk,但是下载新版 sdk 的时候会一直卡在下面这个界面。

the solution to the maui project pairing failure after upgrading the dotnet version 01
图1

既然用 dotnet-install 安装不了,那么我们可以尝试进行手动下载安装,下面就是具体的步骤:

1、先打开 .NET SDK 官网下载页面,然后找到我们需要的版本并进入下载页面,在下载页面中我们需要在表格中找到支持 macOS 的那一行,然后在右侧“二进制文件”那一列找到x64 这个下载地址,表示我们需要下载支持 macOS 的 64 位 dotnet sdk。然后把这个下载地址复制到迅雷中,让迅雷把这个文件下载下来。这个地方为什么用迅雷,因为直接下载有可能太慢或者直接中断。

the solution to the maui project pairing failure after upgrading the dotnet version 02
图2

2、将 1 中下载完成的文件dotnet-sdk-7.0.102-osx-x64.tar.gz复制到 Windows 共享文件夹中,以便在 macOS 中进行访问。然后进入 macOS 系统,依次打开“访达”-“网络”,在右侧出现的计算机列表中找到 Windows 共享文件所在的计算机,然后打开并把共享文件中的 dotnet-sdk-7.0.102-osx-x64.tar.gz 文件复制到 macOS 中。

3、双击 dotnet-sdk-7.0.102-osx-x64.tar.gz 将其解压到 dotnet-sdk-7.0.102-osx-x64 文件夹,然后把里面的所有文件复制到/Users/mac/Library/Caches/Xamarin/XMA/SDKs/dotnet/这个文件夹下,出现同名文件时选择覆盖。

the solution to the maui project pairing failure after upgrading the dotnet version 03
图3

4、将 macOS 中的 Visual Studio for mac 升级到最新版本。

5、切换至 Windows 系统,重启 Visual Studio 2022,重新打开 MAUI 项目进行配对即可,如果还不行就再重启一下 Visual Studio 2022,然后再重新配对。一般最多重复这个步骤 1-2 次可配对成功。

6、如果遇到其它莫名其妙的错误,可以先尝试将/Users/mac/Library/Caches/Xamarin/下的缓存目录XMA删除,然后再重新尝试配对。

Tags: MAUI