先決條件

為了開始使用 Tauri 建置您的專案，您首先需要安裝一些相依性

1. 系統相依性
2. Rust
3. 為行動裝置目標配置 (僅在為行動裝置開發時需要)

系統相依性

依照連結開始設定您各自的作業系統

• Linux (請參閱下方特定發行版)
• macOS Catalina (10.15) 及更高版本
• Windows 7 及更高版本

Linux

Tauri 在 Linux 上開發需要各種系統相依性。這些相依性可能因您的發行版而異，但我們在下方列出了一些常用的發行版，以協助您完成設定。

Debian

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

Arch

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 \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel
sudo dnf group install "c-development"

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-devel \
  libopenssl-devel \
  curl \
  wget \
  file \
  libappindicator3-1 \
  librsvg-devel
sudo zypper in -t pattern devel_basis

Alpine

sudo apk add \
  build-base \
  webkit2gtk \
  curl \
  wget \
  file \
  openssl \
  libayatana-appindicator-dev \
  librsvg

NixOS

注意

這也會為您安裝 Rust 和 Node.js 以及 cargo-tauri CLI，因此您可以跳過下方的這些步驟。

使用 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
  ];
}

如果您的發行版未包含在上方，那麼您可以查看 GitHub 上的 Awesome Tauri，看看是否已建立指南。

下一步：安裝 Rust

macOS

Tauri 使用 Xcode 以及各種 macOS 和 iOS 開發相依性。

從以下位置之一下載並安裝 Xcode

• Mac App Store
• Apple 開發者網站.

請務必在安裝後啟動 Xcode，以便它可以完成設定。

僅為桌面目標開發？

如果您只計劃開發桌面應用程式，而不以 iOS 為目標，那麼您可以改為安裝 Xcode Command Line Tools

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++ 的桌面開發」選項。

下一步：安裝 WebView2。

WebView2

提示

WebView 2 已安裝在 Windows 10 (從 1803 版本起) 和更高版本的 Windows 上。如果您在其中一個版本上開發，則可以跳過此步驟，直接前往安裝 Rust。

Tauri 使用 Microsoft Edge WebView2 來呈現 Windows 上的內容。

造訪 WebView2 Runtime 下載區段安裝 WebView2。下載「Evergreen Bootstrapper」並安裝它。

下一步：安裝 Rust

Rust

Tauri 是使用 Rust 建置的，並且開發需要它。使用以下方法之一安裝 Rust。您可以在 https://www.rust-lang.org/tools/install 查看更多安裝方法。

Linux 和 macOS

使用以下命令透過 rustup 安裝

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

安全提示

我們已審核過此 bash 指令碼，它會執行它聲稱應該執行的操作。儘管如此，在盲目地 curl-bash 指令碼之前，先查看它始終是明智之舉。

以下是作為純指令碼的檔案：rustup.sh

Windows

造訪 https://www.rust-lang.org/tools/install 以安裝 rustup。

或者，您可以使用 winget 使用 PowerShell 中的以下命令來安裝 rustup

winget install --id Rustlang.Rustup

MSVC 工具鏈作為預設值

為了完全支援 Tauri 和 trunk 之類的工具，請確保 MSVC Rust 工具鏈是安裝程式對話方塊中選定的 預設主機三元組。根據您的系統，它應該是 x86_64-pc-windows-msvc、i686-pc-windows-msvc 或 aarch64-pc-windows-msvc。

如果您已經安裝了 Rust，您可以執行此命令來確保安裝了正確的工具鏈

rustup default stable-msvc

請務必重新啟動您的終端機 (在某些情況下，重新啟動您的系統) 以使變更生效。

下一步：如果您想要為 Android 和 iOS 建置，請參閱為行動裝置目標配置，或者，如果您想要使用 JavaScript 框架，請安裝 Node。否則，請參閱建立專案。

Node.js

JavaScript 生態系統

僅當您打算使用 JavaScript 前端框架時

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
• 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 管理器安裝以下項目

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

在 SDK 管理器中選取「顯示套件詳細資訊」可啟用舊版套件的安裝。僅在必要時才安裝舊版本，因為它們可能會引入相容性問題或安全風險。

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")

提示

PowerShell 在重新啟動或登出之前不會接收新的環境變數，但是您可以重新整理目前的會話

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

5. 使用 rustup 新增 Android 目標

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 Command Line Tools。

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 專案！