前置要求

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

1. 系统依赖项
2. Rust
3. 移动端配置 （仅在针对移动设备进行开发时才需要）

系统依赖项

点击链接开始配置，适用于你使用的操作系统：

• Linux （特定发行版请参考下文）
• macOS Catalina (10.15) 或更新
• Windows 7 或更新

Linux

Tauri 在 Linux 上进行开发需要各种系统依赖项。这些可能会有所不同，具体取决于你的发行版，但我们在下面提供了一些流行的发行版来帮助你进行设置。

Debian

sudo apt update
sudo apt install libwebkit2gtk-4.0-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libgtk-3-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev

Arch

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

Fedora

sudo dnf check-update
sudo dnf install webkit2gtk4.0-devel \
  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel
sudo dnf group install "C Development Tools and Libraries"

Gentoo

sudo emerge --ask \
  net-libs/webkit-gtk:4.1 \
  dev-libs/libappindicator \
  net-misc/curl \
  net-misc/wget \
  sys-apps/file

openSUSE

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

NixOS

注意

This will also install Rust and Node.js as well as the cargo-tauri CLI for you, so you can skip those steps below.

Using nix-shell:

let
  pkgs = import <nixpkgs> { };
in
pkgs.mkShell {
  nativeBuildInputs = with pkgs; [
    pkg-config
    gobject-introspection
    cargo
    cargo-tauri
    nodejs
  ];

  buildInputs = with pkgs;[
    at-spi2-atk
    atkmm
    cairo
    gdk-pixbuf
    glib
    gtk3
    harfbuzz
    librsvg
    libsoup_3
    pango
    webkitgtk_4_1
    openssl
  ];
}

如果你的发行版未包含在上面，那么你可能需要查阅 Awesome Tauri on GitHub 以获知是否已有指南被创建。

下一步：下载并安装 Rust

macOS

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

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

• Mac App Store
• Apple Developer 网站.

请务必在安装后启动 Xcode，以使它完成设置。

仅针对桌面目标进行开发？

如果你只打算开发桌面应用程序而不针对 iOS，那么你可以改为安装 Xcode 命令行工具：

xcode-select --install

下一步：下载并安装 Rust

Windows

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

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

Microsoft C++ 构建工具

1. 下载 Microsoft C++ 构建工具 安装程序并打开它以开始安装。
2. 在安装过程中，选中“使用 C++ 进行桌面开发”选项。

下一步：下载并安装 WebView2.

WebView2

提示

WebView 2 已安装在 Windows 10（从版本 1803 开始）和更高版本的 Windows 上。如果你正在这些版本之一上进行开发，则可以跳过此步骤并直接转到 下载并安装 Rust。

Tauri 使用 Microsoft Edge WebView2 在 Windows 上呈现内容。

通过访问 WebView2 Runtime 下载区 安装 WebView2。下载“常青版独立安装程序（Evergreen Boostrapper）”并安装它。

下一步：下载并安装 Rust

Rust

Tauri 使用 Rust 构建并需要它进行开发。使用以下方法之一安装 Rust。你可以在 https://www.rust-lang.org/tools/install 查看更多安装方法。

Linux and macOS

使用 rustup 安装：

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

安全提示

我们已经审核了这个 bash 脚本，它做了它所说的应该做的事情。尽管如此，在盲目地使用脚本之前，先看一看总是明智的。

以下是作为纯文本的脚本文件：rustup.sh

Windows

前往 https://www.rust-lang.org/tools/install 下载 rustup。

请务必重新启动终端（在某些情况下重新启动系统）以使更改生效。

下一步：如果你想要在 Android 或 iOS 上开发应用，前往配置移动端。否则前往创建新项目。

移动端配置

如果你想将应用适配到 Android 或 iOS，则需要安装一些其他依赖项：

• Android
• iOS

Android

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

Linux

export JAVA_HOME=/opt/android-studio/jbr

macOS

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

Windows

[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

4. 配置 ANDROID_HOME 和 NDK_HOME 环境变量：

Linux

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

macOS

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

Windows

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

5. 使用 rustup 添加 Android 编译目标：

Linux and macOS

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

Windows

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

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

iOS

仅 macOS

iOS 开发需要 Xcode，并且仅在 macOS 上可用。确保你在 macOS 系统依赖项部分中安装了 Xcode 而不是 Xcode 命令行工具。

1. 在终端中使用 rustup 将 iOS 添加为编译目标：

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

2. 安装 Homebrew：

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

3. 使用 Homebrew 安装 Cocoapods：

brew install cocoapods

下一步：创建新项目。

故障排除

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

下一步

现在，你已经安装了所有前置要求，你可以准备好创建你的第一个 Tauri 应用程序！