Avalonia 支持通过动态加载程序集(Assembly)+ 反射 + 数据模板(DataTemplate)或视图定位器(ViewLocator)机制,实现插件化架构和运行时切换不同 View。核心不依赖编译期硬引用,而是靠约定、接口抽象与松耦合容器管理。
定义统一插件接口与契约
所有插件需实现同一组基础接口,例如:
IPlugin:声明插件元信息(Id、Name、Version)和生命周期方法(Initialize、Shutdown) IViewProvider:返回可被 Avalonia 渲染的 UserControl 类型(Type),或直接返回已实例化的
IControl可选 ICommand 或 IMenuItem 接口,用于扩展菜单/命令注入
插件项目引用 Avalonia.Core 和你的公共契约库(如
MyApp.Contracts),但不引用主程序 UI 层。
运行时加载插件程序集并发现 View 类型
在主程序中(如 App.xaml.cs 或 MainWindow 中),用
AssemblyLoadContext安全加载插件 DLL: 使用
AssemblyLoadContext.LoadFromAssemblyPath(path)加载插件 遍历其所有类型:
assembly.GetTypes().Where(t => t.IsClass && !t.IsAbstract && typeof(IViewProvider).IsAssignableFrom(t))用反射创建
IViewProvider实例(支持带参构造或无参 + 属性注入) 缓存
(pluginId, viewProvider)映射,供后续按需获取 View 类型
⚠️ 注意:Avalonia 的 XAML 编译器(AvaloniaXamlLoader)默认只认当前程序集中的类型。若插件含自定义 XAML View,需提前调用
AvaloniaRuntimeXamlLoader.Load或启用
CompileWithAvaloniaXaml并确保插件项目正确配置生成 .axaml.g.cs。
动态绑定 View 到 ContentControl 或 Navigation
推荐两种主流方式:
基于 DataTemplate + ViewModel 驱动:为每个插件 View 定义对应 ViewModel(如PluginAViewModel : IPluginViewModel),在主窗口资源中注册
DataTemplate,绑定
ContentControl.Content到当前 ViewModel。Avalonia 自动匹配模板并渲染对应 View 手动创建 View 实例并赋值:调用
viewProvider.CreateView()得到
IControl,再设为
ContentControl.Content。适合需要精细控制生命周期的场景(注意手动处理 DataContext 和资源释放)
若做导航系统(类似 Prism),可封装
IViewStack或继承
ContentControl实现自己的
PluginHostControl,支持路由参数、后退栈、激活/停用通知。
热重载与卸载支持(进阶)
标准 .NET 不支持卸载已加载的 Assembly,但可通过
AssemblyLoadContext创建隔离上下文实现有限卸载: 为每个插件创建独立的
AssemblyLoadContext(
isCollectible: true) 加载插件时指定该上下文;所有依赖(包括 Avalonia 类型)需能跨上下文访问(通常需主程序提供共享上下文或使用
DefaultContext共享基础类型) 调用
context.UnloadAsync()卸载插件 —— 此时需确保无强引用(如事件未解绑、静态缓存未清理)
实践中更常见的是“重启插件”而非真正卸载:重新加载新版本 DLL,替换旧 provider 实例,并触发界面刷新。
基本上就这些。关键在于接口先行、弱引用加载、ViewModel 或类型驱动渲染,再配合合理的生命周期管理。不复杂但容易忽略 XAML 类型解析和 Assembly 卸载限制。
