PAYATHON 2026

如何将 VS2017 的 Xamarin Android 应用迁移到 VS2026？

数据小陈

通常可以复用现有代码，不必从头重写。先确认项目使用的是原生 Xamarin.Android 还是 Xamarin.Forms：前者迁移到 .NET for Android，后者通常迁移到 .NET MAUI。Microsoft 的 Xamarin 支持政策区分了这两条路线。

VS2026 已移除 Xamarin 项目支持，无法仅靠它打开旧解决方案并完成整个迁移。Microsoft 仍将 VS2022 17.14 列为升级旧 Xamarin 项目到 .NET MAUI 的过渡环境。Visual Studio 项目迁移说明

先确认项目类型

可以通过项目的 NuGet 引用、页面代码和布局文件判断项目类型，不能仅凭“使用 Xamarin 开发”确定。

项目特征迁移方向
主要使用 Activity、Android 原生控件和 Resources/layout 下的布局，没有使用 Xamarin.Forms 页面.NET for Android
引用了 Xamarin.Forms，页面使用 ContentPage 等类型.NET MAUI

如果原项目只使用 Android 原生界面，可以继续保留这套界面结构。Microsoft 的原生项目迁移指南说明，大多数项目无需大范围修改命名空间或重写代码，但仍需处理不兼容的依赖和 API。原生 Xamarin 项目迁移指南

哪些工具可以减少工作量？

对于 Xamarin.Forms，.NET Upgrade Assistant 可以转换项目文件，处理部分 NuGet 引用和命名空间替换。工具运行完成后，仍需人工修复和测试，旧插件、自定义控件及平台代码不一定能全部自动迁移。Upgrade Assistant 迁移说明

如果选择 VS2022 作为过渡环境，需要注意工具入口的变化：从 VS 17.14.17 起，Upgrade Assistant 已内置。可以在 Tools → Options → Projects and Solutions → Modernization 中启用 Enable legacy Upgrade Assistant，然后重启。具体以安装版本提供的选项为准。Microsoft 扩展说明

对于原生 Xamarin.Android，Microsoft 推荐新建同类型的 .NET 项目，再迁入代码和资源。新项目采用新的项目结构，现有业务代码仍可逐步复用。

如何逐步迁移原生 Xamarin.Android 项目？

  1. 保留旧项目和发布资料。备份源代码、依赖清单、应用包名、签名资料及可运行的旧安装包，在单独目录或分支中进行迁移。
  2. 创建空的 Android Application 项目。在新环境中选择 .NET for Android 对应模板，先确认空项目能够构建并运行，再迁入旧代码。目标框架使用当前环境支持且适合发布要求的版本。
  3. 先迁业务逻辑。逐步加入数据模型、计算逻辑等代码，再加入 Activity、布局和其他资源。来自 VS2008 的代码应根据实际编译错误检查；代码写法较老本身不代表必须重写。
  4. 逐个检查依赖。核对 NuGet 包是否兼容目标框架。对不兼容的依赖，寻找维护中的版本；有源码的组件可以评估重新编译，没有可用版本时再替换。
  5. 核对项目配置。合并 Manifest、权限、条件编译和签名设置，并检查迁移后生成的配置。不要直接用旧 .csproj 覆盖新项目文件。
  6. 分批构建和测试。每次加入少量功能，先解决依赖和编译问题，再检查界面及运行行为。

这一流程对应 Microsoft 推荐的“创建新项目、合并文件、更新依赖、编译排错”步骤。迁移步骤参考

例如，进入新项目目录后，可以执行以下命令；MigratedApp.csproj 需要替换为实际项目文件名：

dotnet restore MigratedApp.csproj
dotnet build MigratedApp.csproj -c Debug
dotnet build MigratedApp.csproj -c Release

这些命令用于恢复依赖和检查构建。发布签名、打包及设备测试仍需另行完成。

能运行，为什么仍然不能上架？

侧载成功只能说明旧安装包在所测试的设备上能够运行，不能证明它满足当前 Google Play 的提交要求。需要查看 Play Console 的具体提示，不能仅凭使用 VS2017 就确定拒绝原因。

Google Play 对应用的目标 API level 有明确要求。迁移时应核对 targetSdkVersion 及发布时适用的政策，升级 IDE 本身不能代替这项检查。Google Play 目标 API 要求

迁移后还应测试应用实际使用的权限、文件访问和其他 Android 功能，并验证 Release 包。若要更新已上架应用，还需核对应用标识、版本号和发布签名配置。

目前没有项目文件、依赖列表或具体报错，无法判断哪些组件必须替换，也无法估算工作量。可以先迁移一个包含主要依赖和代表性页面的最小版本，确认代码复用范围后，再逐步恢复其余功能。

备注：内容仅供参考。