跳到主要内容

环境搭建

本章节详细介绍各操作系统下 Tauri 开发环境的完整配置过程。

环境要求概览​

Tauri 开发需要以下组件：

组件用途必需
Rust编译 Tauri 核心和后端代码是
系统依赖WebView 和编译工具是
Node.js前端开发和包管理可选

Windows 环境配置​

1. 安装 Microsoft C++ 构建工具​

Tauri 需要 Microsoft C++ 编译器来编译 Rust 代码。

步骤：

  1. 下载 Microsoft C++ Build Tools
  2. 运行安装程序，选择「使用 C++ 的桌面开发」工作负载
  3. 点击安装，等待完成

验证安装：

打开 PowerShell，运行：

cl

如果显示版本信息，说明安装成功。

2. 安装 WebView2​

Tauri 在 Windows 上使用 Microsoft Edge WebView2 作为渲染引擎。

步骤：

  1. 访问 WebView2 Runtime 下载页
  2. 下载「Evergreen Bootstrapper」
  3. 运行安装程序

注意：Windows 11 和部分 Windows 10 版本已预装 WebView2，可以跳过此步骤。

3. 安装 Rust​

方法一：使用 winget（推荐）

winget install Rustlang.Rustup

方法二：使用官方安装脚本

Invoke-WebRequest -Uri https://sh.rustup.rs -OutFile rustup-init.exe
.\rustup-init.exe

安装过程中选择默认选项即可。

验证安装：

rustc --version
cargo --version

输出示例：

rustc 1.75.0 (82e1608df 2024-12-21)
cargo 1.75.0 (1d8b05cdd 2024-12-21)

4. 安装 Node.js（可选）​

如果使用 JavaScript/TypeScript 作为前端，需要安装 Node.js。

  1. 访问 Node.js 官网
  2. 下载 LTS 版本
  3. 运行安装程序

验证安装：

node --version
npm --version

macOS 环境配置​

1. 安装 Xcode 命令行工具​

xcode-select --install

如果提示已安装，则无需操作。

2. 安装 Rust​

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

按照提示完成安装，建议选择默认选项。

使环境变量生效：

source $HOME/.cargo/env

验证安装：

rustc --version
cargo --version

3. 安装 Node.js（可选）​

使用 Homebrew 安装：

brew install node

或从 Node.js 官网 下载安装包。

Linux 环境配置​

Ubuntu / Debian​

安装系统依赖：

sudo apt update
sudo apt install -y \
  libwebkit2gtk-4.1-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  javascriptcoregtk-4.1

安装 Rust：

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env

验证安装：

rustc --version
cargo --version

Arch Linux​

sudo pacman -Syu
sudo pacman -S --needed \
  webkit2gtk-4.1 \
  base-devel \
  curl \
  wget \
  file \
  openssl \
  appmenu-gtk-module \
  libappindicator-gtk3 \
  librsvg

Fedora​

sudo dnf check-update
sudo dnf install \
  webkit2gtk4.1-devel \
  openssl-devel \
  curl \
  wget \
  libappindicator-gtk3-devel \
  librsvg2-devel

配置移动开发环境（可选）​

Tauri 2.0 支持构建 iOS 和 Android 应用。

Android 配置​

1. 安装 Android Studio

下载并安装 Android Studio

2. 配置环境变量

export JAVA_HOME=/Applications/Android\ Studio.app/Contents/jbr/Contents/Home
export ANDROID_HOME=$HOME/Library/Android/sdk
export NDK_HOME=$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)

3. 安装 SDK 组件

在 Android Studio 中打开 SDK Manager，安装：

  • Android SDK Platform
  • Android SDK Platform-Tools
  • NDK (Side by side)
  • Android SDK Build-Tools
  • Android SDK Command-line Tools

4. 添加 Rust 目标

rustup target add \
  aarch64-linux-android \
  armv7-linux-androideabi \
  i686-linux-android \
  x86_64-linux-android

iOS 配置（仅 macOS）​

1. 安装 Xcode

从 Mac App Store 或 Apple Developer 网站下载安装 Xcode。

2. 添加 Rust 目标

rustup target add \
  aarch64-apple-ios \
  x86_64-apple-ios \
  aarch64-apple-ios-sim

3. 安装 CocoaPods

brew install cocoapods

安装 Tauri CLI​

Tauri CLI 是开发 Tauri 应用的主要工具。

使用 cargo 安装（全局）：

cargo install tauri-cli --version "^2.0"

使用 npm 安装（项目本地）：

npm install -D @tauri-apps/cli@latest

验证安装：

cargo tauri --version
# 或
npx tauri --version

创建测试项目​

验证环境是否配置成功：

sh <(curl https://create.tauri.app/sh) --template vanilla

按照提示输入项目名称，然后：

cd <project-name>
npm install
npm run tauri dev

如果成功弹出应用窗口，说明环境配置完成。

常见问题​

Windows: 找不到 lib.exe​

确保已安装「使用 C++ 的桌面开发」工作负载，并重启终端。

Windows: WebView2 未找到​

即使系统已预装 WebView2，某些精简版 Windows 可能缺少开发所需的 SDK。重新安装 WebView2 Runtime 通常可以解决问题。

Linux: 缺少 webkit2gtk​

确保安装了 libwebkit2gtk-4.1-dev（注意是 4.1 版本，不是 4.0）。

Rust: 编译失败​

尝试更新 Rust 工具链：

rustup update

所有平台: 端口被占用​

Tauri 默认使用端口 1420。如果被占用，可以在 tauri.conf.json 中修改：

{
  "build": {
    "beforeDevCommand": "npm run dev -- --port 3000"
  }
}

下一步​

环境配置完成后，你可以：