23.1 插件完整生命周期

Tauri 插件本质上就是一个实现了 Plugin 特征（trait）的 Rust 结构体，它会伴随整个应用的生命周期，在合适的时机被 Tauri 运行时调用。理解插件的生命周期，是开发高质量、无内存泄漏、逻辑可控的插件的基础。

插件的完整生命周期可以分为 注册 → 初始化 → 运行（前后端交互）→ 销毁 四个阶段，每个阶段都有对应的钩子方法可以切入。

1. 注册阶段：构建并挂载插件

在 main() 函数中，通过 .plugin(YourPlugin::new(...)) 将插件实例注册到 Tauri 应用上。此时插件对象被创建，并移交给 Tauri 运行时保管。注册后，插件内部的状态（如配置、资源句柄等）虽已存在，但尚未与 WebView 或窗口建立联系——此时还不能安全地执行与 UI 相关的操作。

fn main() {
    tauri::Builder::default()
        .plugin(my_plugin::init()) // 或 .plugin(MyPlugin::new(config))
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

2. 初始化阶段：`Plugin::initialize`

一旦应用启动、配置加载完毕，第一个被调用的钩子是 initialize。该方法会接收应用的基础信息和配置，你可以在这里完成：

校验配置合法性；
初始化日志、文件目录等不与特定窗口绑定的基础设施；
注册全局 JavaScript API 或状态管理对象；
调用 app.manage() 注入可在 Rust 命令中访问的共享状态。

impl<R: Runtime> Plugin<R> for MyPlugin<R> {
    fn initialize(&mut self, app: &AppHandle<R>, config: serde_json::Value) -> Result<()> {
        // 解析自定义配置
        let my_config: MyConfig = serde_json::from_value(config)?;
        // 注入全局状态
        app.manage(MyState { count: Mutex::new(0) });
        Ok(())
    }
}

注意：此时 WebView 尚未创建，任何依赖窗口或前端的操作（如调用 JS）都应避免。

3. 运行阶段：WebView 就绪与前后端通信

当窗口和 WebView 创建完成，前端页面开始加载时，Tauri 会触发 on_webview_ready 钩子。你可以在此时安全地：

向网页注入脚本、样式；
监听窗口事件（缩放、关闭、聚焦等）；
注册自定义 IPC 命令或事件监听；
初始化与具体窗口绑定的资源（如当前窗口的菜单更新）。

fn on_webview_ready(&mut self, app: &AppHandle<R>, webview: &Webview<R>) -> Result<()> {
    // 注入一个全局函数给前端调用
    webview.eval("window.__MY_PLUGIN_INIT__ = true;")?;
    Ok(())
}

在运行期间，前端通过 Tauri 的 invoke 或事件系统调用插件暴露的命令，响应由 Rust 端处理。插件中可以定义多个命令：

#[tauri::command]
fn my_command(state: tauri::State<MyState>) -> String {
    let mut count = state.count.lock().unwrap();
    *count += 1;
    format!("Value: {}", *count)
}

同时在 Plugin 实现的 extend_api 方法中或者通过 tauri::Builder::invoke_handler 将命令暴露出去。Tauri 2 的插件通常使用 tauri::generate_handler![] 宏统一注册。

4. 销毁阶段：`Plugin::drop` 与资源清理

当应用退出，或某个包含插件的窗口被关闭时，Tauri 运行时会将插件对象销毁，回调 Rust 的 Drop 特征。你可以在自定义插件的 Drop 实现中显式释放资源，例如关闭文件句柄、结束后台线程、保存持久化数据等。

impl<R: Runtime> Drop for MyPlugin<R> {
    fn drop(&mut self) {
        // 确保后台线程优雅退出
        if let Some(handle) = self.thread_handle.take() {
            handle.join().ok();
        }
        println!("Plugin cleaned up.");
    }
}

最佳实践：不要在 Drop 中尝试调用 AppHandle 或做复杂的异步操作，因为此时 Tauri 运行时可能已经开始停机，这些操作可能失败或导致崩溃。所有清理应只涉及插件自身的独立资源。

5. 一个完整生命周期示例（简版）

pub struct MyPlugin<R: Runtime> {
    app: Option<AppHandle<R>>,
}

impl<R: Runtime> Plugin<R> for MyPlugin<R> {
    fn name(&self) -> &'static str {
        "my-plugin"
    }

    fn initialize(&mut self, app: &AppHandle<R>, _config: serde_json::Value) -> Result<()> {
        self.app = Some(app.clone());
        Ok(())
    }

    fn on_webview_ready(&mut self, _app: &AppHandle<R>, webview: &Webview<R>) -> Result<()> {
        webview.eval("console.log('MyPlugin ready')")?;
        Ok(())
    }
}

impl<R: Runtime> Drop for MyPlugin<R> {
    fn drop(&mut self) {
        println!("MyPlugin dropped");
    }
}

掌握插件的生命周期之后，你就能安全地在每个阶段注入自己的逻辑，避免出现资源泄漏、竞态条件或不必要的错误。这也是 Tauri 插件稳定运行的基石。

1. 注册阶段：构建并挂载插件

2. 初始化阶段：Plugin::initialize

3. 运行阶段：WebView 就绪与前后端通信

4. 销毁阶段：Plugin::drop 与资源清理

5. 一个完整生命周期示例（简版）

2. 初始化阶段：`Plugin::initialize`

4. 销毁阶段：`Plugin::drop` 与资源清理