Avalonia 无内置 WebView,推荐使用跨平台的 Avalonia.WebView:Windows 基于 WebView2,macOS 基于 WKWebView,Linux 基于 WebKitGTK;需安装对应 NuGet 包、注册服务、声明控件,并配置平台依赖及 JS 互调。
Avalonia 本身不内置 WebView 控件(如 WPF 的 WebView2 或 UWP 的 WebView),但可通过第三方绑定或原生互操作方式集成浏览器内核。目前主流、稳定且跨平台支持较好的方案是使用 Avalonia.WebView(基于 WebView2 的 Windows + WebViewGTK / WebKitGTK 的 Linux + WebView2/macOS 的 macOS 支持)或更轻量的 Avalonia.Skia.WebView(实验性,基于 Skia 渲染 HTML)。不过生产环境推荐使用官方社区维护较活跃的 Avalonia.WebView。
这是目前 Avalonia 生态中较成熟、跨平台(Windows/macOS/Linux)的 WebView 绑定库,底层在不同平台自动桥接对应原生 WebView:
使用步骤:
Avalonia.WebView(注意匹配 Avalonia 主版本,如 Avalonia 11.x 对应 Avalonia.WebView 11.x)App.xaml.cs 的 OnFrameworkInitializationCompleted 中注册服务(Windows 需初始化 WebView2):(Windows 示例)
if (RuntimePlatform.IsWindows)
{
await WebView2Runtime.InitializeAsync();
}在 XAML 中声明控件:
支持基本导航、JS 互调(ExecuteScriptAsync)、自定义用户代理等。
Linux 平台依赖 WebKitGTK,若运行时报错“Failed to load webkit2gtk”,需确保系统已安装:
sudo apt install libwebkit2gtk-4.1-dev
sudo dnf install webkit2gtk4.1-devel
sudo pacman -S webkit2gtk
同时确认应用运行时有图形环境(X11/Wayland)和 GL 上下文支持(Avalonia 默认使用 Skia+GL 后端)。
若仅需展示静态 HTML/CSS(不执行 JS、不交互),可考虑:
TextBl
ock + 自定义 HTML 解析器(仅适用于极简场景)这类方案无法替代完整 WebView,但适合嵌入帮助文档、Markdown 预览等只读内容。
Avalonia.WebView 支持双向通信:
await webView.ExecuteScriptAsync("alert('Hello from C#');");
webView.RegisterScriptObject("bridge", new JsBridge());,然后在 JS 中访问 window.bridge.invoke(...)
注意:对象需标记 [AllowForWeb],方法需为 public async Task,并返回 Task 或 Task。
基本上就这些。选对绑定库、配好平台依赖、注意 JS 通信的安全边界,就能在 Avalonia 中稳稳用上 WebView。