.NET Upgrade Assistant 更新概述

上个月，.NET Upgrade Assistant 工具进行了更新，引入了第三方 API和包映射支持，旨在简化升级过程。这一更新通过识别和替换过时的第三方 API 和包为最新版本来实现。微软表示，新功能的主要目标是帮助开发者更轻松地完成平台间的过渡，例如从 UWP 迁移到 WinUI，或从 Xamarin Forms 迁移到 .NET MAUI。

更新的背景与挑战

微软希望通过这一工具帮助开发者将旧版应用程序升级到最新版本的 .NET。然而，升级过程中常常面临一个主要挑战：找到第三方库中的等效 API 和 NuGet 包。这一挑战在迁移到新平台时变得更加复杂。

新功能介绍

为了解决上述问题，.NET Upgrade Assistant 现在包含了一系列针对微软自有库的映射。更重要的是，该工具现在支持第三方 API 和包映射，允许第三方开发者为其库指定映射。这些映射详细描述了旧的和新的 API 和包，使 Upgrade Assistant 能够在升级过程中为开发者应用必要的代码和项目更改。

如何创建第三方 API 映射

根据微软的官方公告，创建第三方 API 映射的步骤如下：

1. 阅读 upgrade-assistant GitHub 仓库中的 README.md 文件。
2. 克隆仓库并在 Visual Studio 中打开 UpgradeAssistant.Extensions.sln。
3. 在 UpgradeAssistant.Mappings 项目中创建一个新文件夹，用于存放公司名称和库的子文件夹。
4. 为库添加 *.apimap.json 和 *.packagemap.json 文件，并参考现有映射作为起点。
5. 通过在 Visual Studio 中运行 Pack 命令来创建映射的 NuGet 包。

测试 API 和包映射

微软在公告中详细介绍了如何测试 API 和包映射，开发者可以按照这些步骤进行验证。

提交映射请求

开发者被鼓励在验证映射后，向 upgrade-assistant GitHub 仓库提交拉取请求。一旦微软审核并合并这些更改，CI/CD 管道将创建一个新的 Microsoft.UpgradeAssistant.Mappings 包，并将其发布到 nuget.org。发布后，现有的 .NET Upgrade Assistant 安装将在升级过程中包含这些新映射。

Xamarin.Forms 到 .NET MAUI 的升级支持

.NET Upgrade Assistant 扩展还包含一个专门用于 Xamarin.Forms 到 .NET MAUI 升级的 C# 分析器和代码修复工具。该工具通过识别 Xamarin.Forms 命名空间并应用基于内置和第三方 API 映射的代码更改，帮助用户手动升级代码。

更多信息

感兴趣的读者可以在微软的官方 .NET 网站上找到更多关于 .NET Upgrade Assistant 的信息和详细内容。