Tauri CLI工具详解：从开发到部署的全流程指南-优快云博客

Tauri CLI工具详解：从开发到部署的全流程指南

【免费下载链接】tauri Build smaller, faster, and more secure desktop applications with a web frontend. 项目地址: https://gitcode.com/GitHub_Trending/ta/tauri

引言：为什么选择Tauri CLI？

你还在为Electron应用体积庞大而烦恼吗？还在担心传统桌面应用开发的复杂性吗？Tauri CLI工具将为你提供一站式解决方案。通过本指南，你将掌握从项目初始化到应用部署的全流程，学会如何利用Tauri CLI构建更小、更快、更安全的跨平台桌面应用。

读完本文后，你将能够：

熟练使用Tauri CLI的核心命令
配置和定制Tauri应用的构建过程
掌握应用打包和代码签名的最佳实践
优化Tauri应用的性能和安全性
解决常见的开发和部署问题

Tauri CLI简介

Tauri CLI是Tauri生态系统的核心组件，提供了从开发到部署的全流程工具链。它是一个用Rust编写的命令行工具，支持macOS、Windows和Linux三大主流操作系统。

Tauri CLI的核心优势

特性	Tauri CLI	传统Electron工具
应用体积	极小（依赖系统WebView）	较大（包含完整Chromium）
性能	接近原生	中等（基于Chromium）
安全性	高（沙箱机制+Rust安全特性）	中等（需额外配置安全策略）
跨平台支持	Windows/macOS/Linux	Windows/macOS/Linux
安装包大小	通常<5MB	通常>50MB
内存占用	低	高

Tauri CLI架构概览

mermaid

安装与初始化

系统要求

在安装Tauri CLI之前，请确保你的系统满足以下要求：

Rust 1.60.0或更高版本
Node.js 14.0.0或更高版本
npm/yarn/pnpm包管理器
系统特定依赖：
- Windows: Visual Studio C++ 构建工具
- macOS: Xcode命令行工具
- Linux: WebKit2GTK开发文件

安装Tauri CLI

可以通过以下两种方式安装Tauri CLI：

使用Cargo安装（推荐）

cargo install tauri-cli --locked

使用npm安装

npm install -D @tauri-apps/cli

或使用yarn:

yarn add -D @tauri-apps/cli

或使用pnpm:

pnpm add -D @tauri-apps/cli

初始化Tauri项目

Tauri CLI提供了两种初始化方式：使用tauri init命令或通过模板创建。

1. 在现有项目中初始化

cd your-existing-project
tauri init

运行该命令后，CLI会引导你完成一系列配置：

? 应用名称 my-tauri-app
? 应用窗口标题 My Tauri App
? 应用Web资产目录 (相对路径) ../dist
? 应用开发服务器URL http://localhost:3000
? 是否需要Tauri API的TypeScript类型定义? Yes

2. 使用模板创建新项目

Tauri CLI提供了多种项目模板，可以直接创建完整的应用结构：

# 创建基本的Tauri应用
tauri create my-tauri-app --template vanilla

# 创建使用React框架的Tauri应用
tauri create my-tauri-react-app --template react

# 创建使用Vue框架的Tauri应用
tauri create my-tauri-vue-app --template vue

# 创建使用Svelte框架的Tauri应用
tauri create my-tauri-svelte-app --template svelte

项目结构解析

初始化完成后，Tauri项目会生成以下目录结构：

my-tauri-app/
├── src/                # 前端源代码
├── public/             # 静态资源
├── src-tauri/          # Tauri后端目录
│   ├── Cargo.toml      # Rust项目配置
│   ├── src/            # Rust源代码
│   │   └── main.rs     # 应用入口点
│   ├── tauri.conf.json # Tauri配置文件
│   └── icons/          # 应用图标
├── package.json        # 前端项目配置
└── node_modules/       # 前端依赖

核心命令详解

开发命令：tauri dev

tauri dev命令启动开发环境，包括前端开发服务器和Tauri应用的热重载功能。

tauri dev [OPTIONS]

常用选项

选项	描述
--debug	启用调试模式
--release	以发布模式运行（禁用调试功能）
--no-watch	禁用文件系统监视（不自动重载）
--port	指定开发服务器端口
--open	自动打开应用窗口
--target	指定目标平台三元组

工作流程

mermaid

自定义开发环境

可以通过环境变量自定义开发环境：

# 设置开发服务器端口
TAURI_CLI_PORT=3001 tauri dev

# 指定自定义忽略文件
TAURI_CLI_WATCHER_IGNORE_FILENAME=.tauriignore tauri dev

# 跳过等待前端服务器
TAURI_CLI_NO_DEV_SERVER_WAIT=1 tauri dev

构建命令：tauri build

tauri build命令构建生产就绪的应用程序，优化代码并准备打包。

tauri build [OPTIONS]

常用选项

选项	描述
--debug	构建调试版本
--release	构建发布版本（默认）
--target	指定目标平台三元组
--bundle	构建后自动打包应用
--skip-bundle	只构建不打包
--config	指定自定义配置文件路径

构建过程详解

mermaid

构建优化策略

代码分割与摇树优化

// tauri.conf.json
{
  "build": {
    "beforeBuildCommand": "npm run build -- --prod",
    "devPath": "http://localhost:3000",
    "distDir": "../dist"
  }
}

资源压缩

// tauri.conf.json
{
  "build": {
    "withGlobalTauri": true,
    "resources": [
      {
        "glob": "src/assets/**/*",
        "outputDir": "assets"
      }
    ]
  }
}

条件编译

// src-tauri/src/main.rs
#[cfg(debug_assertions)]
fn enable_dev_features() {
    // 仅在调试模式下启用的功能
}

#[cfg(not(debug_assertions))]
fn enable_prod_features() {
    // 仅在发布模式下启用的功能
}

打包命令：tauri bundle

tauri bundle命令将构建好的应用打包为平台特定的安装包格式。

tauri bundle [OPTIONS]

平台特定输出格式

平台	默认输出格式	可选格式
Windows	MSI	NSIS, ZIP, Appx
macOS	DMG	PKG, ZIP, AppImage
Linux	AppImage	DEB, RPM, Snap, ZIP

常用选项

选项	描述
--target	指定目标平台三元组
--debug	打包调试版本
--release	打包发布版本（默认）
--verbose	显示详细打包过程
--bundle-type	指定打包类型
--skip-signing	跳过代码签名步骤

打包配置示例

// tauri.conf.json
{
  "bundle": {
    "active": true,
    "targets": "all",
    "identifier": "com.example.app",
    "icon": [
      "icons/32x32.png",
      "icons/128x128.png",
      "icons/128x128@2x.png",
      "icons/icon.icns",
      "icons/icon.ico"
    ],
    "resources": [],
    "copyright": "Copyright (c) 2023 Example Corp",
    "category": "DeveloperTool",
    "shortDescription": "A Tauri-based application",
    "longDescription": "A powerful application built with Tauri and Rust",
    "deb": {
      "depends": ["libwebkit2gtk-4.0"]
    },
    "macOS": {
      "entitlements": null,
      "exceptionDomain": "",
      "frameworks": [],
      "minimumSystemVersion": "10.15"
    },
    "windows": {
      "certificateThumbprint": null,
      "digestAlgorithm": "sha256",
      "timestampUrl": "http://timestamp.digicert.com"
    }
  }
}

辅助命令

tauri init

初始化新的Tauri项目或为现有项目添加Tauri支持。

tauri init [OPTIONS]

选项：

--template : 指定项目模板
--app-name : 应用名称
--window-title : 窗口标题</li>
--dist-dir : Web资源目录
--dev-path : 开发服务器URL

tauri info

显示系统信息和Tauri环境详情，用于调试和问题报告。

tauri info

示例输出：

Operating System - Linux, version 5.15.0-56-generic x86_64
Webkit2GTK - 2.38.5
Node.js environment
  Node.js - 16.17.0
  npm - 8.15.0
  yarn - Not installed
Rust environment
  Rustc - 1.65.0
  Cargo - 1.65.0
  rustup - 1.25.1
  rustc - 1.65.0
Tauri environment
  tauri-cli - 1.2.3
  tauri - 1.2.4
  tauri-build - 1.2.1
  tauri-runtime-wry - 0.13.0
  tauri-runtime - 0.13.0
  tauri-macros - 1.2.0
  tauri-config-schema - 0.0.0
  tauri-codegen - 1.2.0
  tauri-utils - 1.2.0

tauri icon

根据源图标生成各种尺寸和格式的应用图标。

tauri icon [OPTIONS] <SOURCE>

示例：

tauri icon src/icon.png --output icons/

这将生成适用于所有平台的图标集，包括：

PNG格式（32x32, 48x48, 64x64, 128x128, 256x256等）
ICNS格式（macOS）
ICO格式（Windows）

配置文件详解

tauri.conf.json结构

Tauri的核心配置文件是tauri.conf.json，位于src-tauri目录下。它使用JSON格式，包含应用的所有配置选项。

{
  "build": {
    "beforeBuildCommand": "",
    "beforeDevCommand": "",
    "devPath": "http://localhost:3000",
    "distDir": "../dist",
    "withGlobalTauri": true
  },
  "package": {
    "productName": "my-tauri-app",
    "version": "0.1.0"
  },
  "tauri": {
    "allowlist": {
      "all": false,
      "window": {
        "all": false,
        "close": true,
        "hide": true,
        "maximize": true,
        "minimize": true,
        "show": true,
        "unmaximize": true,
        "unminimize": true
      },
      "dialog": {
        "all": false,
        "open": true,
        "save": true
      }
    },
    "bundle": {
      "active": true,
      "category": "DeveloperTool",
      "copyright": "",
      "deb": {
        "depends": []
      },
      "externalBin": [],
      "icon": [
        "icons/32x32.png",
        "icons/128x128.png",
        "icons/128x128@2x.png",
        "icons/icon.icns",
        "icons/icon.ico"
      ],
      "identifier": "com.example.app",
      "longDescription": "",
      "macOS": {
        "entitlements": null,
        "exceptionDomain": "",
        "frameworks": [],
        "minimumSystemVersion": "10.15"
      },
      "resources": [],
      "shortDescription": "",
      "targets": "all",
      "windows": {
        "certificateThumbprint": null,
        "digestAlgorithm": "sha256",
        "timestampUrl": ""
      }
    },
    "security": {
      "csp": "default-src 'self'; script-src 'self'"
    },
    "updater": {
      "active": false
    },
    "windows": [
      {
        "fullscreen": false,
        "height": 600,
        "resizable": true,
        "title": "my-tauri-app",
        "width": 800
      }
    ]
  }
}

关键配置项解析

build部分

控制构建过程的配置选项：

beforeBuildCommand: 构建前执行的命令（如npm run build）
beforeDevCommand: 开发前执行的命令（如npm run dev）
devPath: 开发服务器URL
distDir: 生产环境Web资源目录
withGlobalTauri: 是否生成全局window.__TAURI__对象

package部分

应用的基本信息：

productName: 应用名称
version: 应用版本号

tauri部分

Tauri特定配置：

allowlist: 权限白名单，控制前端可访问的API
bundle: 打包相关配置
security: 安全相关设置，如CSP策略
updater: 应用更新配置
windows: 窗口配置

环境变量配置

Tauri CLI支持多种环境变量，用于自定义构建和打包过程：

构建相关环境变量

环境变量	描述
TAURI_CLI_CONFIG_DEPTH	配置文件查找深度
TAURI_CLI_PORT	开发服务器端口
TAURI_CLI_WATCHER_IGNORE_FILENAME	自定义忽略文件名
TAURI_CLI_NO_DEV_SERVER_WAIT	跳过等待前端服务器

代码签名环境变量

环境变量	描述
TAURI_SIGNING_PRIVATE_KEY	签名私钥或文件路径
TAURI_SIGNING_PRIVATE_KEY_PASSWORD	私钥密码
TAURI_WINDOWS_SIGNTOOL_PATH	Windows签名工具路径
APPLE_CERTIFICATE	macOS base64编码证书
APPLE_CERTIFICATE_PASSWORD	macOS证书密码

平台特定环境变量

环境变量	描述	平台
TAURI_LINUX_AYATANA_APPINDICATOR	强制使用Ayatana系统托盘	Linux
TAURI_BUNDLER_WIX_FIPS_COMPLIANT	WiX FIPS合规选项	Windows
APPLE_ID	Apple开发者ID	macOS/iOS
APPLE_PASSWORD	Apple开发者密码	macOS/iOS
APPLE_TEAM_ID	Apple开发团队ID	macOS/iOS

高级功能

自定义命令

Tauri CLI允许你创建自定义命令，扩展其功能以满足特定需求。

在tauri.conf.json中定义自定义命令：

{
  "tauri": {
    "cli": {
      "args": [
        {
          "name": "custom-command",
          "description": "My custom command",
          "takesValue": false,
          "multiple": false,
          "short": "c"
        }
      ]
    }
  }
}

在Rust代码中处理自定义命令：

// src-tauri/src/main.rs
#[tauri::command]
fn handle_custom_command() {
    println!("Custom command executed!");
}

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

使用自定义命令：

tauri custom-command

插件系统

Tauri CLI支持插件系统，允许你扩展应用功能。

安装插件

tauri plugin add <plugin-name>

常用官方插件

插件名称	功能描述
tauri-plugin-dialog	系统对话框集成
tauri-plugin-fs	文件系统访问
tauri-plugin-notification	桌面通知
tauri-plugin-os	操作系统信息
tauri-plugin-path	文件路径处理
tauri-plugin-process	进程管理
tauri-plugin-shell	系统shell访问
tauri-plugin-window	窗口管理增强

创建自定义插件

tauri plugin create my-plugin

插件目录结构：

my-plugin/
├── Cargo.toml
├── src/
│   ├── lib.rs
│   └── api.rs
├── package.json
├── tsconfig.json
└── README.md

多窗口管理

Tauri CLI支持创建和管理多个应用窗口。

在tauri.conf.json中配置多窗口：

{
  "tauri": {
    "windows": [
      {
        "title": "Main Window",
        "width": 800,
        "height": 600,
        "resizable": true,
        "fullscreen": false
      },
      {
        "title": "Secondary Window",
        "width": 600,
        "height": 400,
        "resizable": true,
        "fullscreen": false,
        "label": "secondary"
      }
    ]
  }
}

在Rust代码中管理窗口：

// src-tauri/src/main.rs
use tauri::Window;

#[tauri::command]
fn open_secondary_window(window: Window) {
    window.get_window("secondary").unwrap().show().unwrap();
}

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

在前端代码中调用：

// 打开第二个窗口
window.__TAURI__.invoke('open_secondary_window');

应用更新

Tauri CLI提供内置的应用更新机制。

配置更新服务：

// tauri.conf.json
{
  "tauri": {
    "updater": {
      "active": true,
      "endpoints": [
        "https://example.com/updates/{{target}}/{{arch}}/{{version}}"
      ],
      "dialog": true,
      "pubkey": "dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1Ymxpc2hlciBpZD0xOEI0NEMwNEMzNTZDMzE5QzE4QzIxQzRDMzVDNEMzOUYxNkM0QzE5"
    }
  }
}

发布更新：

tauri build --bundle
# 上传生成的安装包到更新服务器

在应用中检查更新：

// src-tauri/src/main.rs
#[tauri::command]
fn check_updates(app: tauri::AppHandle) -> Result<(), String> {
    let handle = app.handle();
    tauri::async_runtime::spawn(async move {
        if let Ok(update) = tauri_plugin_updater::check_update(&handle).await {
            if update.is_update_available() {
                tauri_plugin_updater::install_update(&handle, update).await.unwrap();
            }
        }
    });
    Ok(())
}

打包与分发

平台特定打包

Tauri CLI为不同平台生成特定的安装包格式：

Windows打包

Windows平台支持多种打包格式：

MSI（默认）
NSIS
ZIP
Appx（Microsoft Store）

# 生成所有支持的Windows包
tauri build --target x86_64-pc-windows-msvc

# 仅生成NSIS安装包
tauri build --target x86_64-pc-windows-msvc --bundle nsis

macOS打包

macOS平台支持的格式：

DMG（默认）
PKG
ZIP
App（应用文件夹）

# 生成macOS安装包
tauri build --target x86_64-apple-darwin
# 或针对Apple Silicon
tauri build --target aarch64-apple-darwin

Linux打包

Linux平台支持的格式：

AppImage（默认）
DEB
RPM
Snap
ZIP

# 生成Linux AppImage
tauri build --target x86_64-unknown-linux-gnu

代码签名

代码签名是确保应用完整性和来源的重要步骤，尤其对于生产环境分发。

Windows代码签名

# 设置签名证书
set TAURI_SIGNING_PRIVATE_KEY=path\to\certificate.pfx
set TAURI_SIGNING_PRIVATE_KEY_PASSWORD=your-password

# 或使用signtool
set TAURI_WINDOWS_SIGNTOOL_PATH="C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\signtool.exe"

# 构建并签名
tauri build

macOS代码签名

# 设置Apple开发者证书
export APPLE_CERTIFICATE=$(cat certificate.p12 | base64)
export APPLE_CERTIFICATE_PASSWORD=your-password
export APPLE_ID=your-apple-id@example.com
export APPLE_PASSWORD=your-apple-password
export APPLE_TEAM_ID=AB12XYZ

# 构建并签名
tauri build

签名验证

签名后，可以验证应用的签名状态：

Windows:

signtool verify /pa your-app.exe

macOS:

codesign -dv --verbose=4 your-app.app

持续集成/持续部署

Tauri CLI可以轻松集成到CI/CD流程中。

GitHub Actions工作流示例

# .github/workflows/tauri-build.yml
name: Build Tauri App

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest, macos-latest]

    steps:
    - uses: actions/checkout@v3

    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: 16

    - name: Install dependencies
      run: npm ci

    - name: Setup Rust
      uses: actions-rs/toolchain@v1
      with:
        toolchain: stable

    - name: Install Tauri CLI
      run: cargo install tauri-cli --locked

    - name: Build Tauri app
      run: tauri build

    - name: Upload artifacts
      uses: actions/upload-artifact@v3
      with:
        name: tauri-build-${{ matrix.os }}
        path: src-tauri/target/release/bundle/

性能优化

应用体积优化

Tauri应用通常已经很小，但你可以通过以下方法进一步减小体积：

优化前端资源
- 使用代码分割
- 压缩和优化图片
- 移除未使用的JavaScript和CSS
- 使用tree-shaking减小依赖体积

Rust编译优化

# src-tauri/Cargo.toml
[profile.release]
opt-level = 'z'     # 最大化大小优化
lto = true          # 链接时优化
codegen-units = 1   # 单代码生成单元（优化大小）
panic = 'abort'     # 中止而不是展开panic（减小体积）
strip = true        # 剥离调试符号

资源优化配置

// tauri.conf.json
{
  "build": {
    "resources": [
      {
        "glob": "src/assets/**/*",
        "outputDir": "assets",
        "filter": {
          "exclude": ["**/*.md", "**/*.txt"]
        }
      }
    ]
  }
}

启动速度优化

Tauri应用启动速度通常很快，但可以通过以下方法进一步优化：

延迟初始化

// src-tauri/src/main.rs
fn main() {
  tauri::Builder::default()
    .setup(|app| {
      // 只初始化必要组件
      let handle = app.handle();
      tauri::async_runtime::spawn(async move {
        // 延迟初始化非关键组件
        init_secondary_components(handle).await;
      });
      Ok(())
    })
    .run(tauri::generate_context!())
    .expect("error while running tauri application");
}

优化Web资源加载
- 使用预加载关键资源
- 实现启动屏(splash screen)
- 延迟加载非关键组件

启动性能分析

# 使用tauri dev进行性能分析
tauri dev --profile performance

内存使用优化

WebView优化

// tauri.conf.json
{
  "tauri": {
    "windows": [
      {
        "webviewAttributes": {
          "disableContextMenu": true,
          "disableDevTools": true
        }
      }
    ]
  }
}

Rust内存管理
- 使用适当的数据结构
- 避免不必要的克隆
- 及时释放资源
- 使用内存分析工具如valgrind或heaptrack

常见问题与解决方案

开发环境问题

问题：tauri dev启动失败，提示WebView未找到

解决方案：

安装WebKit2GTK开发包：

# Ubuntu/Debian
sudo apt-get install libwebkit2gtk-4.0-dev

# Fedora
sudo dnf install webkit2gtk4.0-devel

# Arch Linux
sudo pacman -S webkit2gtk

问题：热重载不工作

解决方案：

检查tauri.conf.json中的distDir和devPath配置是否正确

确保没有忽略必要的文件：

# 创建.tauriignore文件，确保没有忽略源代码目录
echo "!src/**/*" > .tauriignore

尝试禁用防火墙或安全软件，它们可能阻止开发服务器通信

构建与打包问题

问题：Windows构建失败，提示缺少MSVC工具链

解决方案：

安装Microsoft Visual C++ Build Tools
或安装Visual Studio 2019/2022并勾选"使用C++的桌面开发"工作负载

确保设置了正确的环境变量：

call "C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvars64.bat"

问题：macOS打包失败，提示代码签名错误

解决方案：

确保安装了Xcode命令行工具：
```
xcode-select --install
```
检查Apple开发者证书是否正确安装：
```
security find-identity -v -p codesigning
```

确保设置了正确的环境变量：

export APPLE_ID=your-apple-id@example.com
export APPLE_PASSWORD=your-app-specific-password
export APPLE_TEAM_ID=your-team-id

运行时问题

问题：应用在Linux上无法启动，提示缺少库

解决方案：

安装所需的依赖库：

# Ubuntu/Debian
sudo apt-get install libgtk-3-0 libwebkit2gtk-4.0-37 libappindicator3-1

# Fedora
sudo dnf install gtk3 webkit2gtk4.0 libappindicator-gtk3

问题：Windows Defender误报病毒

解决方案：

提交应用到Microsoft进行误报分析
确保正确签名应用
在开发阶段，可以将应用添加到Windows Defender排除项：
```
Add-MpPreference -ExclusionPath "C:\path\to\your\app.exe"
```

总结与展望

Tauri CLI是一个功能强大的工具，提供了从开发到部署的全流程支持。通过本文的介绍，你已经了解了Tauri CLI的核心功能、配置选项和最佳实践。

关键要点回顾

Tauri CLI提供了简洁而强大的命令集，支持开发、构建和打包全流程
tauri.conf.json是配置应用行为的核心
环境变量提供了灵活的构建和打包定制方式
插件系统扩展了Tauri的功能，满足特定需求
代码签名和优化是生产环境部署的关键步骤
Tauri应用体积小、性能高、安全性好，是传统Electron应用的理想替代品

Tauri生态系统展望

Tauri项目正在快速发展，未来版本将带来更多令人兴奋的功能：

改进的移动平台支持（iOS/Android）
更丰富的内置API
更好的开发工具集成
增强的插件生态系统

随着Web技术和Rust语言的不断发展，Tauri有望成为跨平台应用开发的首选框架之一。

进一步学习资源

官方文档：https://tauri.app/docs/
GitHub仓库：https://gitcode.com/GitHub_Trending/ta/tauri
Tauri Discord社区：https://discord.gg/tauri
Tauri示例项目：https://github.com/tauri-apps/tauri-examples
Tauri博客：https://tauri.app/blog/

希望本文能帮助你充分利用Tauri CLI构建出色的跨平台应用。如有任何问题或反馈，请随时在Tauri社区中提出。祝你开发愉快！

如果你觉得本文对你有帮助，请点赞、收藏并关注作者，以获取更多Tauri开发技巧和最佳实践。

下期预告：Tauri应用安全最佳实践

【免费下载链接】tauri Build smaller, faster, and more secure desktop applications with a web frontend. 项目地址: https://gitcode.com/GitHub_Trending/ta/tauri

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考