Tauri 应用快速入门：基于 `create-tauri-app`

Tauri 应用快速入门：基于 create-tauri-app

create-tauri-appRapidly scaffold out a new tauri app project.项目地址:https://gitcode.com/gh_mirrors/cr/create-tauri-app

---

一、项目目录结构及介绍

当你通过 https://github.com/tauri-apps/create-tauri-app.git 初始化一个新项目时，将会得到以下典型的项目结构：

my-tauri-app/
├── Cargo.lock             # Rust依赖关系锁定文件
├── Cargo.toml             # Rust项目配置文件，定义了项目依赖和元数据
├── src/
│   ├── main.rs            # 主Rust入口点，控制应用生命周期
│   └── lib.rs             # 可选，用于库代码
├── tauri.conf.json        # Tauri应用程序的配置文件
├── package.json           # Node.js的包管理配置，包含脚本和依赖项，用于前端构建
├── yarn.lock              # 如果使用Yarn，此文件锁定特定版本的依赖项
├── build.rs               # Rust构建脚本，自定义编译逻辑（可选）
├── assets                 # 存放静态资源的目录
├── dist                   # 编译后的前端应用输出目录（由Webpack等工具生成）
├── .gitignore             # Git忽略文件列表
└── README.md               # 项目说明文档

• Cargo.lock 和 Cargo.toml：负责Rust部分的依赖管理和构建。
• src/main.rs：Tauri应用的主要逻辑所在，处理与原生平台的交互。
• tauri.conf.json：核心配置文件，定义窗口属性、命令、安全策略等。
• package.json 和 yarn.lock：管理前端JavaScript应用的构建和依赖。
• assets: 用户放置需随应用打包的任何静态资产。

---

二、项目的启动文件介绍

主要文件：main.rs

main.rs 是Tauri应用的核心启动文件，它：

1. 引入必要的Tauri框架和API。
2. 配置Tauri应用，例如设置窗口大小、图标、初始化全局事件监听器。
3. 定义与前端JavaScript通信的RPC（远程过程调用）函数。
4. 启动Tauri应用的运行循环。

示例代码简化版可能如下面所示：

use tauri::{Builder, Window};

fn main() {
    Builder::default()
        .setup(|app| {
            // 可以在这里进行应用级的初始操作
            Ok(())
        })
        .run(tauri::RunEvent::Close(_))?;
}

---

三、项目的配置文件介绍

tauri.conf.json

tauri.conf.json 是Tauri应用的关键配置文件，它决定了应用的行为、外观和安全性等方面。关键字段包括：

• windows: 定义你的应用窗口，包括其尺寸、标题、是否全屏或透明等。
• build: 控制应用如何被打包，包括输出目录、是否启用调试等选项。
• updater: 更新设置，如果应用支持自动更新。
• asar: 是否将资源打包成asar归档格式。
• security: 包括allowRunningInSecureContext等，以加强应用的安全性。
• **TAURI`: 其他高级配置，比如命令、事件监听等。

示例配置片段：

{
  "windows": [
    {
      "title": "我的Tauri应用",
      "url": "index.html",
      "width": 800,
      "height": 600
    }
  ],
  "build": {
    "devPath": "./dist",
    "distDir": "./dist",
    ...
  },
  ...
}

确保仔细阅读并理解这些配置项，因为它们直接影响到最终的应用行为和用户体验。

---

这个文档提供了一个基本的概览，帮助你理解和搭建基于Tauri的应用程序。深入学习Tauri框架时，每个部分都有更丰富的特性和细节值得探索。

create-tauri-appRapidly scaffold out a new tauri app project.项目地址:https://gitcode.com/gh_mirrors/cr/create-tauri-app