# tauri-test-prj

**Repository Path**: TechCrazy/tauri-test-prj

## Basic Information

- **Project Name**: tauri-test-prj
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-14
- **Last Updated**: 2026-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tauri 功能演示项目

这是一个基于 Tauri 框架开发的桌面应用程序演示项目，展示了 Tauri 的核心功能和架构设计。

## 项目简介

该项目使用 Tauri 2.x 框架，结合 TypeScript 和 Rust 开发，实现了一个功能完整的桌面应用程序。项目演示了 Tauri 的基本命令调用、文件系统操作等核心功能。

## 技术栈

| 技术 | 版本 | 用途 |
|------|------|------|
| Tauri | 2.x | 跨平台桌面应用框架 |
| TypeScript | ~5.6.2 | 前端开发语言 |
| Rust | 1.92.0 | 后端开发语言 |
| Vite | ^6.0.3 | 前端构建工具 |

## 架构设计

### 整体架构

Tauri 应用采用前后端分离的架构设计：

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   前端界面      │     │   Tauri 核心    │     │   Rust 后端     │
│  (HTML/CSS/TS)  │────▶│   (IPC 通信)    │────▶│   (业务逻辑)    │
└─────────────────┘     └─────────────────┘     └─────────────────┘
```

### 目录结构

```
.
├── src/                 # 前端源代码
│   ├── assets/          # 静态资源文件
│   ├── main.ts          # 前端主逻辑
│   └── styles.css       # 样式文件
├── src-tauri/           # Tauri 后端源代码
│   ├── capabilities/    # 权限配置
│   ├── icons/           # 应用图标
│   ├── src/             # Rust 源代码
│   │   ├── lib.rs       # 核心业务逻辑
│   │   └── main.rs      # 应用入口
│   ├── Cargo.toml       # Rust 依赖配置
│   └── tauri.conf.json  # Tauri 应用配置
├── index.html           # HTML 入口文件
├── package.json         # 前端依赖配置
├── tsconfig.json        # TypeScript 配置
└── vite.config.ts       # Vite 配置
```

### 核心模块

1. **前端模块**
   - 负责用户界面渲染
   - 处理用户交互
   - 通过 Tauri API 调用后端命令

2. **Tauri 核心模块**
   - 提供 IPC 通信机制
   - 管理应用窗口
   - 处理系统级别的功能

3. **Rust 后端模块**
   - 实现核心业务逻辑
   - 处理文件系统操作
   - 提供命令接口供前端调用

## 功能特性

### 1. 基本命令调用

- **功能描述**：演示前端如何调用 Rust 后端命令
- **实现方式**：通过 `invoke()` 函数调用 Rust 中定义的 `greet` 命令
- **代码位置**：
  - 前端：`src/main.ts`
  - 后端：`src-tauri/src/lib.rs`

### 2. 文件系统操作

- **功能描述**：演示 Tauri 应用如何操作文件系统
- **实现方式**：Rust 后端提供文件操作命令，前端通过 API 调用
- **支持的操作**：
  - 列出目录文件
  - 读取文件内容
  - 写入文件
- **代码位置**：
  - 前端：`src/main.ts`
  - 后端：`src-tauri/src/lib.rs`

## 安装与运行

### 环境要求

- Node.js >= 18.x
- Rust >= 1.86.0
- Visual Studio Build Tools (Windows) 或 Xcode (macOS) 或 GCC (Linux)

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd tauri-test-prj
   ```

2. **安装依赖**
   ```bash
   npm install
   ```

3. **开发模式运行**
   ```bash
   npm run dev
   ```

4. **构建生产版本**
   ```bash
   npm run tauri build
   ```

### 运行方式

1. **开发模式**
   - 执行 `npm run dev`
   - 浏览器访问 http://localhost:1420/

2. **桌面应用模式**
   - 执行 `npm run tauri dev`
   - 或运行构建后的可执行文件：`src-tauri/target/release/tauri-app.exe`

## 开发指南

### 前端开发

- 修改 `src/main.ts` 添加前端逻辑
- 修改 `src/styles.css` 添加样式
- 修改 `index.html` 修改页面结构

### 后端开发

- 在 `src-tauri/src/lib.rs` 中添加 Rust 命令
- 命令使用 `#[tauri::command]` 宏标记
- 在 `tauri::generate_handler!` 中注册命令

### 常用命令

| 命令 | 描述 |
|------|------|
| `npm run dev` | 启动前端开发服务器 |
| `npm run build` | 构建前端代码 |
| `npm run tauri dev` | 启动 Tauri 开发模式 |
| `npm run tauri build` | 构建 Tauri 生产版本 |
| `cargo check` | 检查 Rust 代码 |
| `cargo fmt` | 格式化 Rust 代码 |

## 项目配置

### Tauri 配置

主要配置文件：`src-tauri/tauri.conf.json`

- **app**：应用基本配置（窗口大小、标题等）
- **build**：构建配置（前端路径、构建命令等）
- **bundle**：打包配置（图标、版本等）

### 前端配置

主要配置文件：`vite.config.ts`

- 配置前端构建选项
- 配置开发服务器

## 功能演示

### 1. 基本命令调用

1. 在输入框中输入您的名字
2. 点击"打招呼"按钮
3. 下方会显示来自 Rust 后端的问候信息

### 2. 文件系统操作

- **列出当前目录文件**：点击"列出当前目录文件"按钮，显示当前目录的文件列表
- **读取 package.json**：点击"读取 package.json"按钮，显示 package.json 文件的内容
- **写入测试文件**：点击"写入测试文件"按钮，在当前目录创建一个测试文件

## 打包与分发

### 构建生产版本

```bash
npm run tauri build
```

构建产物位于：`src-tauri/target/release/`

### 支持的平台

- Windows (x86_64)
- macOS (x86_64, aarch64)
- Linux (x86_64)

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！

## 致谢

- Tauri 团队：提供了优秀的跨平台桌面应用框架
- Rust 社区：提供了强大的后端开发支持
- TypeScript 社区：提供了类型安全的前端开发体验

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- Email: [your-email@example.com]
- GitHub: [your-github-username]