Tauri Plugin Decorum 项目教程

Tauri Plugin Decorum 项目教程

tauri-plugin-decorum Opinionated window decoration controls for apps built with the Tauri framework. 项目地址: https://gitcode.com/gh_mirrors/ta/tauri-plugin-decorum

1. 项目目录结构及介绍

tauri-plugin-decorum 项目是一个为 Tauri 应用提供自定义窗口装饰的插件。项目的目录结构如下：

• examples/tauri-app: 一个使用 tauri-plugin-decorum 插件的示例 Tauri 应用。
• src: 包含插件源代码的目录。
• .github: 包含 GitHub 工作流的目录。
• Cargo.toml: Rust 项目的配置文件。
• LICENSE: 项目的 MIT 许可证文件。
• README.md: 项目的自述文件，包含项目介绍和安装使用说明。
• build.rs: Rust 构建脚本。
• package.json: Node.js 项目的配置文件。
• rollup.config.js: Rollup 打包配置文件。
• tsconfig.json: TypeScript 配置文件。
• yarn.lock: Yarn 锁定文件。

2. 项目的启动文件介绍

项目的启动主要是通过 Tauri 的 main.rs 文件来实现的。以下是启动文件的基本结构：

// 引入必要的模块和依赖
use tauri::{Manager, WebviewWindowExt};
use tauri_plugin_decorum::init;

fn main() {
    // 默认构建器
    tauri::Builder::default()
        // 添加插件
        .plugin(tauri_plugin_decorum::init())
        // 设置应用配置
        .setup(|app| {
            // 获取主窗口
            let main_window = app.get_webview_window("main").unwrap();
            // 创建自定义标题栏
            main_window.create_overlay_titlebar().unwrap();
            // macOS 特定设置
            #[cfg(target_os = "macos")]
            {
                main_window.set_traffic_lights_inset(12.0, 16.0).unwrap();
                main_window.make_transparent().unwrap();
                main_window.set_window_level(25).unwrap();
            }
            Ok(())
        })
        // 运行应用
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

这段代码展示了如何初始化 Tauri 应用并添加 tauri-plugin-decorum 插件。

3. 项目的配置文件介绍

项目的配置主要通过 tauri.conf.json 文件来管理。以下是一些基本配置：

• tauri > plugin: 定义了插件的相关配置。
• tauri > builder > setup: 设置应用启动时的配置。
• tauri > windows: 定义了窗口的配置，包括窗口的标题、大小、位置等。

在 src-tauri/capabilities/default.json 文件中，你需要设置窗口的权限，如下所示：

{
  "core:window:allow-close": true,
  "core:window:allow-center": true,
  "core:window:allow-minimize": true,
  "core:window:allow-maximize": true,
  "core:window:allow-set-size": true,
  "core:window:allow-set-focus": true,
  "core:window:allow-is-maximized": true,
  "core:window:allow-start-dragging": true,
  "core:window:allow-toggle-maximize": true,
  "decorum:allow-show-snap-overlay": true
}

此外，tauri.conf.json 中的 withGlobalTauri 选项需要设置为 true，以启用全局 Tauri 功能。

tauri-plugin-decorum Opinionated window decoration controls for apps built with the Tauri framework. 项目地址: https://gitcode.com/gh_mirrors/ta/tauri-plugin-decorum