选用 NativeWebView 必须从 Avalonia11 升级 Avalonia12 的 5 大核心原因 + 11 版本原生 WebView 痛点 + 升级改造清单
关键结论：Avalonia11 的 NativeWebView 是商业付费闭源组件、缺陷多、跨平台残缺；Avalonia12 官方将 NativeWebView 完全开源免费、架构重构、补齐全平台、JS 互交互稳、兼容 SukiUI/MapUI 生态，是落地 NativeWebView 唯一优选版本Avalonia UI
一、最核心：授权费用原因（首要升级动因）
二、功能 & 跨平台补齐：11 版本 NativeWebView 天生残缺，12 全平台完善
1.Avalonia11 原生缺陷
- Linux 平台不支持内嵌 NativeWebView 控件，只能弹窗 NativeWebDialog，无法在页面布局内嵌网页（你的大屏项目布局刚需内嵌）Avalonia；
- WASM（浏览器部署）、Android 内嵌 WebView 为实验版，JS 双向通信偶发崩溃、内存泄漏；
- 缺少UserAgent自定义、Cookie 全局拦截、WebView2 环境自定义、网页打印 PDF、OAuth 授权弹窗原生支持等常用 API。
2.Avalonia12 补齐全平台
- Linux 正式支持内嵌 NativeWebView（WpeWebView 后端），Windows (WebView2)/macOS (WKWebView)/Linux/WebAssembly/Android/iOS 全平台统一内嵌渲染，完美适配大屏布局；
- 新增全套 Web 配置 API：UA、持久化缓存目录、请求 Header 拦截、网页 PDF 打印、原生 Web 授权弹窗；
- JS/C# 双向消息通信架构重构，彻底修复 11 版本跨线程调用卡死、消息丢失 BUG（你 WebView 和高德 JS 交互高频使用）。
三、渲染 & 控件融合：解决经典 Airspace（空域穿透）BUG（大屏刚需）
四、生态兼容：适配 SukiUI6→7、MapUI5.0 升级（你现有项目依赖）
五、性能 & 打包：体积、AOT、内存大幅优化
六、Avalonia11→12 NativeWebView 代码变更清单（你项目必改）
1.NuGet 包替换
xml
<!–移除11付费包–>
<!–<PackageReference Include="Avalonia.Controls.WebView" Version="11.x"/>–>
<!–12开源免费包，无Licensing依赖–>
<PackageReference Include="Avalonia.Controls.WebView" Version="12.0.x"/>
<!–平台运行时包（Windows必装）–>
<PackageReference Include="Avalonia.WebView.Windows" Version="12.0.x"/>
2.AppBuilder 注册
csharp
运行
//11不需要注册；12必须在BuildAvaloniaApp添加
AppBuilder.Configure<App>()
.UsePlatformDetect()
.UseWebView() //WebView全局初始化
.UseSukiUI();
3.XAML 命名空间（无变化，控件名依旧 NativeWebView）
xml
xmlns:web="clr-namespace:Avalonia.Controls.WebView;assembly=Avalonia.Controls.WebView"
<web:NativeWebView Source="xxx"/>
4.JS 互操作 API 微调
11：webView.InvokeScriptAsync()；12 方法名不变，WebMessageReceived 事件参数结构微调，JS 传参 JSON 解析逻辑少量适配。
