跳到内容
Tauri

先决条件

要开始使用 Tauri 构建项目,您首先需要安装一些依赖项

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

请点击链接以开始为您的操作系统进行设置

Tauri 在 Linux 上开发需要各种系统依赖。这些可能因您的发行版而异,但我们已在下面列出了一些流行的发行版以帮助您进行设置。

终端窗口
sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
build-essential \
curl \
wget \
file \
libxdo-dev \
libssl-dev \
libayatana-appindicator3-dev \
librsvg2-dev

如果您的发行版未包含在上述列表中,您可能需要查看 GitHub 上的 Awesome Tauri,看看是否已创建了相关指南。

下一步:安装 Rust

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

从以下位置下载并安装 Xcode

请务必在安装后启动 Xcode,以便其完成设置。

只为桌面端目标开发?如果您只打算开发桌面应用程序且不针对 iOS,那么您可以改为安装 Xcode Command Line Tools

终端窗口
xcode-select --install

下一步:安装 Rust

Tauri 在 Windows 上开发使用 Microsoft C++ Build Tools 和 Microsoft Edge WebView2。这两者都是在 Windows 上开发所必需的。

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

  1. 下载 Microsoft C++ Build Tools 安装程序并打开它以开始安装。
  2. 安装过程中请勾选“使用 C++ 的桌面开发”选项。

Visual Studio C++ Build Tools installer screenshot

下一步:安装 WebView2

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

通过访问WebView2 运行时下载部分安装 WebView2。下载并安装“常青引导程序”。

下一步:检查 VBSCRIPT

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

如果在构建 MSI 包时遇到 failed to run light.exe 等错误,您可能需要启用 VBSCRIPT 功能

  1. 打开设置应用可选功能更多 Windows 功能
  2. 在列表中找到 VBSCRIPT 并确保其被选中
  3. 点击下一步,如果出现提示,请重新启动您的计算机

注意: VBSCRIPT 目前在大多数 Windows 安装中默认启用,但正在被弃用,并可能在未来的 Windows 版本中被禁用。

下一步:安装 Rust

Tauri 使用 Rust 构建,开发时需要它。请使用以下方法之一安装 Rust。您可以在 https://rust-lang.net.cn/tools/install 查看更多安装方法。

使用以下命令通过 rustup 安装

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

请务必重新启动您的终端(在某些情况下是您的系统),以使更改生效。

下一步:如果您想为 Android 和 iOS 构建应用程序,请配置移动端目标;或者,如果您想使用 JavaScript 框架,请安装 Node。否则,请创建项目

  1. 前往 Node.js 网站,下载长期支持 (LTS) 版本并安装。
  2. 运行以下命令检查 Node 是否成功安装
终端窗口
node -v
# v20.10.0
npm -v
# 10.2.3

务必重启终端以确保其识别新安装。在某些情况下,您可能需要重启计算机。

虽然 npm 是 Node.js 的默认包管理器,但您也可以使用 pnpm 或 yarn 等其他管理器。要启用这些管理器,请在终端中运行 corepack enable。此步骤是可选的,仅在您偏好使用 npm 以外的包管理器时才需要。

下一步:为移动端目标配置创建项目

如果您想将应用程序目标定为 Android 或 iOS,则需要安装一些额外的依赖项

  1. Android 开发者网站 下载并安装 Android Studio
  2. 设置 JAVA_HOME 环境变量
终端窗口
export JAVA_HOME=/opt/android-studio/jbr
  1. 使用 Android Studio 中的 SDK 管理器安装以下内容
  • Android SDK 平台
  • Android SDK 平台工具
  • NDK(并排)
  • Android SDK 构建工具
  • Android SDK 命令行工具

在 SDK 管理器中选择“显示包详情”可以安装旧版本的软件包。仅在必要时才安装旧版本,因为它们可能会引入兼容性问题或安全风险。

  1. 设置 ANDROID_HOMENDK_HOME 环境变量。
终端窗口
export ANDROID_HOME="$HOME/Android/Sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"
  1. 使用 rustup 添加 Android 目标
终端窗口
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

下一步:为 iOS 设置创建项目

  1. 在终端中用 rustup 添加 iOS 目标
终端窗口
rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim
  1. 安装 Homebrew
终端窗口
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. 使用 Homebrew 安装 Cocoapods
终端窗口
brew install cocoapods

下一步:创建项目

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


© 2025 Tauri 贡献者。CC-BY / MIT