跳转到内容
Tauri

先决条件

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

  1. 系统依赖项
  2. Rust
  3. 为移动目标配置(仅当针对移动设备开发时需要)

系统依赖项

点击链接开始您相应的操作系统的配置

Linux

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

macOS

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

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

确保安装后启动 Xcode,以便它完成设置。

只针对桌面目标进行开发?如果您只计划开发桌面应用程序且不针对 iOS,则可以安装 Xcode 命令行工具。

终端窗口
xcode-select --install

下一节:安装 Rust

Windows

Tauri 使用 Microsoft C++ Build Tools 以及 Microsoft Edge WebView2 进行开发。这些都是在 Windows 上开发所必需的。

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

Microsoft C++ Build Tools

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

Visual Studio C++ Build Tools installer screenshot

下一节:安装 WebView2

WebView2

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

通过访问 WebView2 实时下载部分 来安装 WebView2。下载“Evergreen Boostrapper”并安装。

下一节:安装 Rust

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。否则创建项目

Node.js

  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定位应用,则需要安装一些额外的依赖项

Android

  1. Android开发者网站下载并安装Android Studio
  2. 设置JAVA_HOME环境变量
终端窗口
export JAVA_HOME=/opt/android-studio/jbr
  1. 使用Android Studio中的SDK Manager安装以下内容
  • Android SDK Platform
  • Android SDK Platform-Tools
  • NDK(并行安装)
  • Android SDK Build-Tools
  • Android SDK Command-line Tools

在SDK Manager中选择“显示包详细信息”可以使安装旧版包版本成为可能。只有在必要时才安装旧版本,因为它们可能会引入兼容性问题或安全风险。

  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设置创建项目

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