Avalonia的生命周期 之一

对于从WinForms（或WPF）转向Avalonia的开发者来说，最关心的莫过于“我之前的知识还能用多少？”。

好消息是，Avalonia在设计上借鉴了许多经典桌面框架的经验，因此在窗口生命周期方面，你会找到很多似曾相识的感觉，但它作为现代跨平台框架，也有自己独特的设计和考量。

整体认知：Avalonia生命周期 vs. WinForms生命周期

简单来说，Avalonia的生命周期管理可以分为两个层面：应用程序生命周期（类似WinForms的Application类）和窗口生命周期（类似WinForms的Form）。下面这个对比可以帮你快速建立概念映射：

功能点	WinForms 概念	Avalonia 概念
应用入口	Main 方法中的 Application.Run()	Program.cs 中的 BuildAvaloniaApp().StartWithClassicDesktopLifetime(args)
主窗口设置	Application.Run(new MainForm())	在 App.axaml.cs 的 OnFrameworkInitializationCompleted 中，通过 IClassicDesktopStyleApplicationLifetime.MainWindow 赋值
应用关闭模式	通过 Application.Exit() 等控制	通过 IClassicDesktopStyleApplicationLifetime.ShutdownMode 设置（如OnLastWindowClose， OnMainWindowClose）
窗口事件	Load， Shown， Activated， FormClosing， FormClosed 等	Opened， Activated， Deactivated， Closing， Closed 等
控件事件	Control.HandleCreated， Control.HandleDestroyed	AttachedToVisualTree， DetachedFromVisualTree

一、 应用程序生命周期：从 Main 函数开始

在WinForms中，启动逻辑通常在Main函数和Application类中。在Avalonia里，这个过程同样清晰，但更显式地分为两步。

1. 标准启动流程

• 入口点 (Program.cs)： 这是应用的起点。你在这里配置跨平台细节，并选择一种“生命周期”启动方式。对于桌面应用，通常是 StartWithClassicDesktopLifetime 。

// Program.cs
class Program
{public static void Main(string[] args) => BuildAvaloniaApp().StartWithClassicDesktopLifetime(args); // 指定使用经典的桌面应用生命周期public static AppBuilder BuildAvaloniaApp()=> AppBuilder.Configure<App>().UsePlatformDetect() // 自动检测并适配Windows、macOS、Linux.LogToTrace();
}

• 应用初始化 (App.axaml.cs)： 这是设置应用全局资源、样式以及最重要的——创建主窗口的地方。OnFrameworkInitializationCompleted 方法是一个关键的生命周期方法，它标志着框架初始化完成，此时可以安全地创建和显示UI 。

// App.axaml.cs
public override void OnFrameworkInitializationCompleted()
{// 判断当前是哪种生命周期模式if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop){// 在这里设置你的主窗口，就像WinForms的 Application.Run(new MainForm())desktop.MainWindow = new MainWindow();// 你可以在这里配置关闭模式，例如：当最后一个窗口关闭时，应用才退出desktop.ShutdownMode = ShutdownMode.OnLastWindowClose;}// 对于移动端或WebAssembly，可能是另一种生命周期else if (ApplicationLifetime is ISingleViewApplicationLifetime singleView){singleView.MainView = new MainView();}base.OnFrameworkInitializationCompleted();
}

2. 生命周期接口与关闭模式

Avalonia通过接口来提供不同层级的生命周期控制。IClassicDesktopStyleApplicationLifetime 是我们最常用的 。它提供了：

• MainWindow： 获取或设置主窗口。
• Windows： 获取当前打开的所有窗口的列表，你可以像WinForms的Application.OpenForms一样遍历它们。
• ShutdownMode： 这是控制应用何时退出的关键，有三种模式：
  • OnLastWindowClose (默认)： 当最后一个窗口关闭时，应用程序退出。这与大多数现代应用的行为一致。
  • OnMainWindowClose： 只有当通过MainWindow属性设置的主窗口关闭时，应用才退出。这更接近WinForms的默认行为。
  • OnExplicitShutdown： 禁用自动关闭。你需要手动调用 desktop.Shutdown() 方法来退出应用。这在需要严格控制退出流程（如保存所有文档后）时非常有用。
• Shutdown(int exitCode)： 手动关闭应用程序的方法。
• Startup 和 Exit 事件： 订阅应用程序的启动和退出事件。

二、 窗口生命周期：从创建到关闭

一个Window实例的生命周期，与WinForms的Form生命周期极为相似，事件名称也基本能望文生义。

1. 创建与初始化

• 构造函数： 在这里进行最基础的属性设置，如标题、宽高，或者通过InitializeComponent() 加载XAML定义的UI 。
• Opened 事件： 当窗口被成功打开并显示在屏幕上后触发。这相当于WinForms中的 Shown 事件。你可以在此时执行一些需要确保窗口句柄已创建的操作，如启动动画或进行后续的初始化 。

2. 激活与显示状态

• Activated 事件： 当窗口获得焦点，成为用户当前交互的前台窗口时触发。这与WinForms的 Activated 事件完全对应 。
• Deactivated 事件： 当窗口失去焦点，例如用户切换到另一个应用时触发。非常适合在此暂停动画、视频播放或高频轮询，以节省资源 。
• Loaded 事件： 这是从控件（Control）层面继承来的事件，当窗口（作为一个内容控件）完成布局、渲染并加入到可视树中后触发。它比 Opened 更早一点发生，但含义稍有不同，更侧重于UI元素的“加载完成” 。
• Unloaded 事件： 当窗口从可视树中移除时触发，是进行资源清理的另一个好地方 。

3. 关闭与销毁

• Closing 事件： 这是窗口开始关闭流程时触发的第一个事件。最重要的特性是它可以被取消 。
  • 事件参数 CancelEventArgs 有一个 Cancel 属性。如果你在事件处理程序中将 e.Cancel = true，窗口关闭操作将被中止，窗口保持打开状态。这完美地对应了WinForms中的 FormClosing 事件，非常适合用来弹出“是否保存更改”的对话框。

// MainWindow.axaml.cs 代码隐藏
protected override void OnClosing(CancelEventArgs e)
{// 检查是否有未保存的数据if (this.DataContext is MainViewModel viewModel && viewModel.HasUnsavedChanges){// 假设你弹出一个自定义对话框询问用户var result = MessageBox.Show(this, "有未保存的更改，确定退出吗？", "提示", MessageBoxButton.YesNo);if (result == MessageBoxResult.No){e.Cancel = true; // 取消关闭窗口}}base.OnClosing(e);
}

• Closed 事件： 当窗口已经被成功关闭后触发。这个事件不可取消。在这里进行最终的、确定性的资源清理，如释放非托管资源、取消事件订阅等。这与WinForms的 FormClosed 事件一致 。

三、 从WinForms迁移的注意事项

当你开始用Avalonia编写代码时，以下几点值得特别留意：

1. 跨平台导致的差异：

   • 在移动端和浏览器（WebAssembly）平台上，没有“窗口”这个概念。因此，在这些平台上，你不能使用Window类，而需要使用MainView和ISingleViewApplicationLifetime。你的代码需要通过条件判断或依赖注入来适应不同平台，不过好在大多数业务逻辑在MVVM模式下可以复用 。

2. 异常处理陷阱：

   • 这是一个比较隐蔽的细节。在窗口的生命周期事件（如 Activated、Deactivated、Closing、Closed）中直接抛出的异常，可能不会被通常的全局异常捕获器（如 AppDomain.UnhandledException）捕获到，而是直接导致程序崩溃 。
   • 对策：在这些事件的处理方法内部，务必使用 try-catch 包裹你的逻辑。或者，你也可以借助 Dispatcher.UIThread.Post 来执行代码，这样异常就能被外层的消息循环捕获到 。

   // 推荐的做法
   this.Closing += async (sender, e) =>
   {try{// 你的业务逻辑，比如保存数据await SaveDataAsync();}catch (Exception ex){// 记录异常或通知用户Logger.LogError(ex, "窗口关闭时出错");}
   };
   

3. 获取主窗口的正确方式：

   • 虽然可以通过静态方式 (Application.Current.ApplicationLifetime as IClassicDesktopStyleApplicationLifetime)?.MainWindow 获取到主窗口，但官方文档并不推荐你在任意地方都这样使用。因为如果你在非主窗口的上下文中（比如一个弹出对话框里）需要获取一个顶层窗口来作为父窗口，应该使用当前最特定的那个顶层窗口（例如，通过 VisualRoot 来获取），而不是静态的主窗口。这样能避免对话框从错误的所有者窗口中弹出，造成不好的用户体验 。

4. UI组件的“视觉树”生命周期：

   • 除了窗口本身，每个控件也有类似的生命周期事件：AttachedToVisualTree（当控件被添加到窗口的UI树上）和 DetachedFromVisualTree（当控件被移除）。这些事件是进行控件级初始化和清理的好地方 。

总结

从WinForms转向Avalonia，在窗口生命周期这部分你会感到很顺畅。核心逻辑是相通的：应用启动（Main → 设置主窗口） → 窗口打开（Opened） → 窗口交互（Activated/Deactivated） → 窗口关闭（可取消的Closing → 最终的Closed）。

你需要适应的是Avalonia对跨平台的显式处理（如生命周期接口）和一些更细粒度的控制选项（如ShutdownMode）。记住那个关于异常处理的提醒，它在实际开发中能帮你避免一些比较难排查的崩溃问题。