Avalonia如何实现一个Webview控件 Avalonia集成浏览器内核

来源：这里教程网时间：2026-02-21 17:35:28 作者：

Avalonia 本身不内置 WebView 控件（如 WPF 的 WebView2 或 UWP 的 WebView），但可通过第三方绑定或原生互操作方式集成浏览器内核。目前主流、稳定且跨平台支持较好的方案是使用 Avalonia.WebView（基于 WebView2 的 Windows + WebViewGTK / WebKitGTK 的 Linux + WebView2/macOS 的 macOS 支持）或更轻量的 Avalonia.Skia.WebView（实验性，基于 Skia 渲染 HTML）。不过生产环境推荐使用官方社区维护较活跃的 Avalonia.WebView。

使用 Avalonia.WebView（推荐）

这是目前 Avalonia 生态中较成熟、跨平台（Windows/macOS/Linux）的 WebView 绑定库，底层在不同平台自动桥接对应原生 WebView：

Windows：基于 Microsoft Edge WebView2（需系统安装 Edge 运行时或嵌入 SDK） macOS：基于 WKWebView（系统自带，无需额外依赖） Linux：基于 WebKitGTK（需系统安装 libwebkit2gtk-4.1 或对应版本）

使用步骤：

安装 NuGet 包：
Avalonia.WebView
（注意匹配 Avalonia 主版本，如
Avalonia 11.x
对应
Avalonia.WebView 11.x
）

在
App.xaml.cs
的
OnFrameworkInitializationCompleted
中注册服务（Windows 需初始化 WebView2）：

（Windows 示例）

if (RuntimePlatform.IsWindows)
{
    await WebView2Runtime.InitializeAsync();
}

在 XAML 中声明控件：

<webView:WebView
    Width="800"
    Height="600"
    Source="https://example.com"
    NavigationStarting="OnNavigationStarting"
    NavigationCompleted="OnNavigationCompleted" />

支持基本导航、JS 互调（

ExecuteScriptAsync

）、自定义用户代理等。

Linux 下注意事项（WebKitGTK）

Linux 平台依赖 WebKitGTK，若运行时报错“Failed to load webkit2gtk”，需确保系统已安装：

Ubuntu/Debian：
sudo apt install libwebkit2gtk-4.1-dev
Fedora/RHEL：
sudo dnf install webkit2gtk4.1-devel
Arch：
sudo pacman -S webkit2gtk

同时确认应用运行时有图形环境（X11/Wayland）和 GL 上下文支持（Avalonia 默认使用 Skia+GL 后端）。

替代方案：简单 HTML 渲染（无 JS）

若仅需展示静态 HTML/CSS（不执行 JS、不交互），可考虑：

Avalonia.HtmlRenderer（社区项目，基于 AngleSharp + Skia 渲染，轻量但功能有限）用
TextBlock
+ 自定义 HTML 解析器（仅适用于极简场景）

这类方案无法替代完整 WebView，但适合嵌入帮助文档、Markdown 预览等只读内容。

JS 与 C# 通信（关键能力）

Avalonia.WebView 支持双向通信：

C# 调用 JS：
await webView.ExecuteScriptAsync("alert('Hello from C#');");
JS 调用 C#：
webView.RegisterScriptObject("bridge", new JsBridge());
，然后在 JS 中访问
window.bridge.invoke(...)

注意：对象需标记