Tauri 創(chuàng)建 Rust 項目

每款 Tauri 應用的核心都是由一個管理窗口的 Rust 二進制文件、WebView 和進行系統(tǒng)調(diào)用的 tauri Rust 包構(gòu)成。 此項目使用官方的軟件包管理器及 Rust 通用構(gòu)建工具 Cargo 來管理。

我們的 Tauri CLI 工具會在底層自動調(diào)用 Cargo，所以您大部分情況下無需和其交互。 Cargo 有諸多我們的 CLI 工具所未提供的有用功能，包括測試、分析及格式化工具。請參閱其官方文檔來了解更多。

安裝 TAURI CLI
如果你還沒有安裝Tauri CLI，你可以使用下面的一個命令進行安裝。 不確定該用哪個？ 請參閱常見問題。

• npm

npm install --save-dev @tauri-apps/cli

為了使npm能夠正確檢測到Tauri，您需要將其添加到package.json文件中的"scripts"部分：

package.json

"scripts": {
  "tauri": "tauri"
}

• Yarn

yarn add -D @tauri-apps/cli

• pnpm

pnpm add -D @tauri-apps/cli

• Cargo

cargo install tauri-cli

要搭建一個使用 Tauri 的簡單 Rust 項目，請打開終端并運行如下命令：

• npm

npm run tauri init

• Yarn

yarn tauri init

• pnpm

pnpm tauri init

• Cargo

cargo tauri init

它會向您詢問幾個問題：

1. 您應用的名字是什么？- 這將會是您打包后和操作系統(tǒng)會調(diào)用的應用名稱。 您可以在此處填寫任何您想要的名稱。
2. 窗口標題叫什么？- 這將會是您主窗口的默認標題。 您可以在此處填寫任何您想要的名稱。
3. 前端頁面資源 (HTML/CSS/JS) 相對于 <current dir>/src-tauri/tauri.conf.json 文件將被創(chuàng)建的位置？- 這是 production環(huán)境時tauri加載web前端資源的目錄.Use ?../dist? for this value.
4. 開發(fā)環(huán)境時的加載路徑？ - 可以是一個網(wǎng)絡地址也可以是一個文件路徑 development.Use ?http://localhost:5173? for this value.
5. 你將使用什么命令來開發(fā)前端頁面？- 這是啟動前端開發(fā)服務器的命令。使用 `npm run dev`（請確保根據(jù)您選擇的包管理器進行適應）。
6. 你將使用什么命令來構(gòu)建前端頁面？- 這是構(gòu)建前端文件的命令。

信息
若您已熟悉 Rust，您會發(fā)現(xiàn) tauri init 看起來很像 cargo init 命令。 若您想自己設(shè)置，您完全可以使用 cargo init 替代此命令，并手動添加 Tauri 依賴。

tauri init 命令將生成 src-tauri 文件夾。 傳統(tǒng)上，Tauri 應用會將其核心相關(guān)的文件放置于此文件夾中。 讓我們快速過一下此文件夾中的內(nèi)容：

• ?Cargo.toml?

Cargo 的清單文件。 您可以聲明您應用所依賴的 Rust 包和應用的元數(shù)據(jù)等等。 要查看所有可修改的值，請參閱 Cargo 清單格式 。

• ?tauri.conf.json?

此文件可讓您自定義 Tauri 應用的各方各面，包括應用名稱到允許的 API 列表。 請參閱 Tauri 的 API 配置 來深入了解每個支持的選項。

• ?src/main.rs?

這是你的 Rust 程序的入口，也是我們啟動 Tauri 的地方。 您可以發(fā)現(xiàn)它由兩個部分組成：

src/main.rs 

 #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]

fn main() {
tauri::Builder::default()
   .run(tauri::generate_context!())
   .expect("error while running tauri application");
}

The line beginning with the ?cfg! 宏? 所開始的一行僅有一個目的：關(guān)閉構(gòu)建好的應用在 Windows 上運行時一般會出現(xiàn)的控制臺窗口。 若您是 Windows 用戶，您可以試試去掉這行看看會發(fā)生什么。

?main? 函數(shù)是您程序的入口點，也是運行時調(diào)用的第一個函數(shù)。

• ?圖標?

您可能想為自己的應用整一個漂亮的圖標！ 為了幫助您快速開發(fā)，我們?yōu)槟峁┝艘惶啄J圖標。 您應該在發(fā)布前把這些圖標換成您自己的圖標。 您可以在 Tauri 的 圖標功能指南 中了解有關(guān)多種圖標格式的信息。

現(xiàn)在我們已經(jīng)搭建好了前端并初始化了Rust項目，創(chuàng)建的 tauri.conf.json 文件應該如下所示：

src-tauri/tauri.conf.json

{
  "build": {
    // 當你運行 `tauri build` 時，將會執(zhí)行這個命令。
    "beforeBuildCommand": "npm run build",
    // 當你運行 `tauri dev`時，將會執(zhí)行這個命令。
    "beforeDevCommand": "npm run dev",
    "devPath": "http://localhost:5173",
    "distDir": "../dist"
  },

就是這樣！ 現(xiàn)在您可以在您的終端中運行接下來的命令來開始您的應用程序的開發(fā)構(gòu)建：

• npm

npm run tauri dev

• Yarn

yarn tauri dev

• pnpm

pnpm tauri dev

• Cargo

cargo tauri dev