Visual Studio创建Avalonia新项目默认v11-Preview4，如何切换至v11-Preview7？

一、创建基于最新Preview7版本的Avalonia项目 #

方法1：更新Visual Studio中的Avalonia模板 #

• 打开Visual Studio，点击顶部菜单栏的工具→获取工具和功能，启动Visual Studio Installer。
• 在安装界面的已安装标签下，找到**.NET桌面开发工作负载，点击修改**。
• 切换到单个组件，搜索“Avalonia”，选择对应最新的v11-Preview7模板组件进行安装，完成后重启Visual Studio。
• 再次创建Avalonia项目时，即可选择Preview7版本的模板。

方法2：创建后手动升级包版本 #

• 先按默认流程创建Avalonia项目（默认是Preview4）。
• 右键项目→管理NuGet程序包，在浏览标签中搜索所有Avalonia相关包（如Avalonia、Avalonia.Desktop、Avalonia.Themes.Fluent等），将所有包的版本统一切换到v11-Preview7，点击安装完成更新。

二、Preview4升级到Preview7后的编译失败修复 #

Avalonia v11预览版迭代中存在破坏性变更，以下是常见问题的修复步骤：

1. 修正项目文件配置 #

• 打开项目的.csproj文件，确认<TargetFramework>为兼容的.NET版本（推荐net8.0，Preview7对新版本.NET支持更好）。
• 移除旧的<AvaloniaVersion>属性，确保所有Avalonia相关包的版本号一致为Preview7。
• 确保项目SDK引用和基础配置正确，示例配置如下：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <BuiltInComInteropSupport>true</BuiltInComInteropSupport>
    <AvaloniaUseCompiledBindings>true</AvaloniaUseCompiledBindings>
  </PropertyGroup>

2. 调整XAML语法 #

• 检查XAML文件中的错误提示，Preview7调整了部分控件属性和命名空间：
  • 确认控件命名空间为最新的xmlns:avalonia="https://github.com/avaloniaui"；
  • 修正绑定语法或控件属性的使用方式，比如部分旧版Content属性的写法需要适配新API。

3. 更新后台代码逻辑 #

• 根据编译错误提示，替换过时的API：
  • 例如，Application类的初始化方法，旧版的AvaloniaXamlLoader.Load(this)需改为InitializeComponent()；
  • 检查窗口启动、事件处理等逻辑，替换Preview7中已修改或移除的方法/属性。

4. 清理重建项目 #

• 完成上述修改后，点击生成→清理解决方案，再执行重建解决方案，清除旧编译缓存，避免残留文件导致的异常。

内容的提问来源于stack exchange，提问作者Honza Gybas