docs: 添加构建指南

Author: ByteMancer-png

README.md

@@ -79,6 +79,10 @@ RestLite是适用于Windows与Linux平台的文件备份工具，提供简单直
     Linux:
     `~/.local/share/io.github.rest-lite`
 
+## 🛠️ 构建指南
+
+[构建指南](doc/how_to_build.zh.md)
+
 ## 📝 问题反馈
 
 请至[Issues](https://github.com/rest-lite/RestLite/issues)页面提交问题或功能请求

doc/README.en.md

@@ -78,6 +78,10 @@ In addition to removing the application and backup repository, you should also d
     Linux:
     `~/.local/share/io.github.rest-lite`
 
+## 🛠️ Build Guide
+
+[Build Guide](how_to_build.en.md)
+
 ## 📝 Issue Reporting
 
 Please submit issues or feature requests on the [Issues](https://github.com/rest-lite/RestLite/issues) page.

doc/how_to_build.en.md

@@ -0,0 +1,74 @@
+# 🛠️ Build Guide
+
+## 📦 Prerequisites
+
+Flutter Desktop requires that the build environment matches the target platform. That is, to build for **Windows**, you must compile on **Windows**; to build for **Linux**, you must compile on **Linux**.
+
+> 📌 This guide is based on **Windows 11** and **Ubuntu 24.04 LTS**.
+
+## ⚙️ Environment Setup
+
+This project depends on Flutter, Rust, and flutter rust bridge.
+
+Please refer to the official documentation for installing Flutter and Rust:
+
+* [Install Flutter](https://docs.flutter.dev/get-started/install)
+* [Install Rust](https://www.rust-lang.org/tools/install)
+
+To install flutter rust bridge using Cargo:
+
+```shell
+# Install flutter rust bridge
+cargo install flutter_rust_bridge_codegen
+```
+
+### 🐧 Additional Steps for Linux
+
+Due to [tray_manager requirements](https://github.com/leanflutter/tray_manager?tab=readme-ov-file#quick-start), you need to install the following package on Linux:
+
+```shell
+sudo apt-get install libayatana-appindicator3-dev
+```
+
+## 🧱 Code Generation
+
+The scaffolded code generated by flutter rust bridge is excluded from version control, so it must be generated manually:
+
+```shell
+# Generate flutter rust bridge code
+flutter_rust_bridge_codegen generate
+```
+
+## 🏗️ Build Application
+
+```shell
+# Windows
+flutter build windows --release
+
+# Linux
+flutter build linux --release
+```
+
+> 💡 **Tip:** If you attempt to build without generating code first, you may encounter a permission error on Linux. Run `flutter clean` before building to resolve this.
+
+## 📁 Add restic Executable
+
+The application expects the `restic` binary to be located in the `bin` directory. Please create a `bin` folder and place the appropriate version of `restic` for your system inside it.
+
+Download restic from:
+[Restic Releases](https://github.com/restic/restic/releases)
+
+Example directory structure:
+
+```shell
+project_root/
+├── bin/
+│   └── restic      # The restic binary for your platform
+├── data/
+├── RestLite
+└── ...
+```
+
+## 📝 Feedback & Issues
+
+If you encounter any issues during the build process, please submit a ticket on the [Issues](https://github.com/rest-lite/RestLite/issues) page or refer to the [GitHub Action build script](../.github/workflows/flutter-build.yml).

doc/how_to_build.zh.md

@@ -0,0 +1,74 @@
+# 🛠️ 构建指南
+
+## 📦 前置条件
+
+flutter desktop要求编译环境必须与目标平台相同，即目标平台为Windows必须在Windows中编译，目标平台为Linux必须在Linux中编译。
+
+> 📌本指南基于**Windows 11**与**Ubuntu 24 TLS**。
+
+## ⚙️ 环境配置
+
+本项目依赖Flutter、Rust与flutter rust bridge。
+
+Flutter与Rust的安装请参考官方文档：
+
+- [Install Flutter](https://docs.flutter.dev/get-started/install)
+- [Install Rust](https://www.rust-lang.org/tools/install)
+
+flutter rust bridge的安装使用cargo:
+
+```shell
+# 安装 flutter rust bridge
+cargo install flutter_rust_bridge_codegen
+```
+
+### 🐧 Linux的额外步骤
+
+Linux中因为[tray_manager的要求](https://github.com/leanflutter/tray_manager?tab=readme-ov-file#quick-start)，需要额外安装`libayatana-appindicator3-dev`。
+
+```shell
+sudo apt-get install libayatana-appindicator3-dev
+```
+
+## 🧱 生成代码
+
+flutter rust bridge的脚手架代码被排除在版本控制之外，所以需要先生成代码
+
+```shell
+# 生成frb代码
+flutter_rust_bridge_codegen generate
+```
+
+## 🏗️ 构建应用
+
+```shell
+# Windows
+flutter build windows --release
+
+#Linux
+flutter build linux --release
+```
+
+> 💡 **Tip:** 如果没有进行代码生成就直接进行编译，linux会报错提示没有权限，建议运行一次`flutter clean`清理缓存再进行编译。
+
+## 📁 添加restic可执行文件
+
+程序默认调用 `bin` 目录下的 `restic` 二进制文件，请手动创建 `bin` 文件夹，并放入对应平台的 `restic` 执行文件：
+
+restic下载地址:
+[Restic Releases](https://github.com/restic/restic/releases)
+
+示例目录结构:
+
+```shell
+project_root/
+├── bin/
+│   └── restic      # 放入你系统对应的 restic 可执行文件
+├── data/
+├── RestLite
+└── ...
+```
+
+## 📝 问题反馈
+
+对构建过程有疑问可以至[Issues](https://github.com/rest-lite/RestLite/issues)页面提交问题，或者参考[github action 构建文件](../.github/workflows/flutter-build.yml)