2 前置条件

原文链接: https://tauri.app/start/prerequisites/

要开始使用 Tauri 构建项目，你需要先安装一些依赖：

1. 系统依赖
2. Rust
3. 配置移动端目标（仅在为移动端开发时需要）

系统依赖

请按各自的操作系统点击对应链接开始：

• Linux（具体发行版见下文）
• macOS Catalina (10.15) 及更高版本
• Windows 7 及更高版本

Linux

在 Linux 上开发 Tauri 需要各种系统依赖。它们可能因发行版而异，下面列出了一些流行的发行版来帮助你完成配置。

发行版

• Debian
• Arch
• Fedora
• Gentoo
• OSTree
• openSUSE
• Alpine
• NixOS

1
2
3
4
5
6
7
8
9

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

1
2
3
4
5
6
7
8
9

sudo dnf install webkit2gtk4.1-devel \
  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel \
  libxdo-devel
sudo dnf group install "c-development"

1
2
3
4
5

  net-libs/webkit-gtk:4.1 \
  dev-libs/libayatana-appindicator \
  net-misc/curl \
  net-misc/wget \
  sys-apps/file

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel \
  libxdo-devel \
  gcc \
  gcc-c++ \
  make
sudo systemctl reboot

1
2
3
4
5
6
7
8

sudo zypper in webkit2gtk3-devel \
  libopenssl-devel \
  curl \
  wget \
  file \
  libappindicator3-1 \
  librsvg-devel
sudo zypper in -t pattern devel_basis

1
2
3
4
5
6
7
8

  build-base \
  webkit2gtk-4.1-dev \
  curl \
  wget \
  file \
  openssl \
  libayatana-appindicator-dev \
  librsvg

注意：Alpine Linux 容器默认不包含任何字体。为确保 Tauri 应用中的文本能正确渲染，请至少安装一个字体包（例如 font-dejavu）。

注意：Alpine 面向 musl C 库，因此 Rust 构建会静态链接若干系统库。如果 cargo/pnpm tauri build 因链接错误而失败，提示缺少 pkg-config 报告为存在的库中的符号，请在上面 -dev 包之外再安装对应的 *-static 包：

1 2 3 4 5 6 7

sudo apk add --no-cache \ openssl-libs-static \ cairo-static \ harfbuzz-static \ glib-static \ wayland-static \ zlib-static

并非 Tauri 引入的所有依赖在 Alpine 上都有 *-static 打包版本；遇到这种情况，你可能需要从源码构建缺失的静态库。

如果你的发行版不在上面的列表中，可以到 GitHub 上的 Awesome Tauri 看看是否已有人编写了指南。

下一步：安装 Rust

macOS

Tauri 使用 Xcode 以及各种 macOS 和 iOS 开发依赖。

请从以下位置之一下载并安装 Xcode：

• Mac App Store
• Apple 开发者网站

安装完成后请务必启动 Xcode，以便它完成初始化设置。

1

xcode-select --install

下一步：安装 Rust

Windows

Tauri 在 Windows 上开发时使用 Microsoft C++ 生成工具以及 Microsoft Edge WebView2。二者都是在 Windows 上开发的必备项。

请按以下步骤安装所需的依赖。

Microsoft C++ 生成工具

1. 下载 Microsoft C++ 生成工具安装程序并打开，开始安装。
2. 安装过程中勾选“使用 C++ 的桌面开发”选项。

下一步：安装 WebView2。

WebView2

Tauri 在 Windows 上使用 Microsoft Edge WebView2 渲染内容。

请访问 WebView2 运行时下载页面安装 WebView2。下载 “Evergreen Bootstrapper” 并安装。

下一步：检查 VBSCRIPT

VBSCRIPT（用于 MSI 安装包）

在 Windows 上构建 MSI 包需要启用 VBSCRIPT 可选功能。大多数 Windows 安装中该功能默认启用，但某些系统上可能已被禁用。

如果在构建 MSI 包时遇到类似 failed to run light.exe 的错误，你可能需要启用 VBSCRIPT 功能：

1. 打开 设置 → 应用 → 可选功能 → 更多 Windows 功能
2. 在列表中找到 VBSCRIPT 并确认它已勾选
3. 点击 下一步，如有提示则重启计算机

注意： 目前大多数 Windows 安装都默认启用 VBSCRIPT，但它正被弃用，未来的 Windows 版本中可能会被禁用。

下一步：安装 Rust

Rust

Tauri 使用 Rust 构建，开发时也需要它。请使用以下方法之一安装 Rust。更多安装方法请见 https://www.rust-lang.org/tools/install 。

操作系统

• Linux 与 macOS
• Windows

1

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

1

winget install --id Rustlang.Rustup

1

rustup default stable-msvc

下一步：如果你想为 Android 和 iOS 构建，请配置移动端目标；如果你想使用 JavaScript 框架，请安装 Node。否则请创建项目。

Node.js

1. 前往 Node.js 网站，下载长期支持（LTS）版本并安装。
2. 运行以下命令检查 Node 是否安装成功：

1
2
3

# v20.10.0
npm -v
# 10.2.3

重启终端很重要，这样才能确保它识别到新的安装。某些情况下，你可能需要重启计算机。

虽然 npm 是 Node.js 的默认包管理器，你也可以使用 pnpm 或 yarn 等其它包管理器。要启用它们，请在终端中运行 corepack enable。这一步是可选的，仅当你偏好使用 npm 之外的包管理器时才需要。

下一步：配置移动端目标或创建项目。

配置移动端目标

如果你想把应用定位到 Android 或 iOS，还需要安装一些额外的依赖：

• Android
• iOS

Android

1. 从 Android 开发者网站下载并安装 Android Studio
2. 设置 JAVA_HOME 环境变量：

操作系统

• Linux
• macOS
• Windows

1

export JAVA_HOME=/opt/android-studio/jbr

1

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"

1

[System.Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Android\Android Studio\jbr", "User")

3. 使用 Android Studio 中的 SDK Manager 安装以下内容：

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

在 SDK Manager 中勾选 “Show Package Details” 即可安装旧版本包。仅在必要时安装旧版本，因为它们可能引入兼容性问题或安全风险。

4. 设置 ANDROID_HOME 和 NDK_HOME 环境变量。

• Linux
• macOS
• Windows

1
2

export ANDROID_HOME="$HOME/Android/Sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

1
2

export ANDROID_HOME="$HOME/Library/Android/sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

1
2
3

[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "$env:LocalAppData\Android\Sdk", "User")
$VERSION = Get-ChildItem -Name "$env:LocalAppData\Android\Sdk\ndk" | Select-Object -Last 1
[System.Environment]::SetEnvironmentVariable("NDK_HOME", "$env:LocalAppData\Android\Sdk\ndk\$VERSION", "User")

1

[System.Environment]::GetEnvironmentVariables("User").GetEnumerator() | % { Set-Item -Path "Env:\$($_.key)" -Value $_.value }

5. 使用 rustup 添加 Android 目标：

1

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

下一步：配置 iOS 或创建项目。

iOS

1. 在终端中使用 rustup 添加 iOS 目标：

1

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

2. 安装 Homebrew：

1

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. 使用 Homebrew 安装 Cocoapods：

1

brew install cocoapods

下一步：创建项目。

故障排除

如果在安装过程中遇到任何问题，请务必查看故障排除指南，或到 Tauri Discord 寻求帮助。

现在你已经安装好全部前置条件，可以创建你的第一个 Tauri 项目了！