Tauri 2.0 环境准备指南:从零开始构建你的桌面应用 - 安装 Node.js、Rust 和 Tauri CLI

Tauri 2.0 环境准备指南:从零开始构建你的桌面应用 - 安装 Node.js、Rust 和 Tauri CLI
最新回答
玖歌

2020-12-04 04:48:04

Tauri 2.0 环境准备需依次完成 Node.js、Rust 和 Tauri CLI 的安装,并通过验证确保环境配置正确。 以下是详细步骤说明:

一、安装 Node.js

Node.js 是 Tauri 管理前端依赖和构建工具的基础,需优先安装。

  • 下载安装包访问

    Node.js 官方网站
    ,根据操作系统选择稳定版(LTS)安装包下载。

  • 运行安装程序双击下载的 .msi(Windows)或 .pkg(macOS)文件,按向导提示完成安装。Linux 用户可通过包管理器安装(如 sudo apt install nodejs npm)。

  • 验证安装结果打开终端,输入以下命令检查版本号:

    node -vnpm -v

    若显示版本号(如 v18.16.0),则安装成功。

二、安装 Rust 和 Cargo

Rust 是 Tauri 后端逻辑的核心语言,Cargo 为其包管理工具。

  • 下载安装脚本访问

    Rust 官方网站
    ,点击 Get Started,选择对应操作系统的安装脚本(如 Windows 的 rustup-init.exe)。

  • 执行安装命令

    Windows/macOS:双击脚本文件运行。

    Linux/macOS 终端:输入以下命令:

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

    按提示选择默认配置,安装完成后需重新打开终端使环境变量生效。

  • 验证安装结果输入以下命令检查版本号:

    rustc --versioncargo --version

    若显示版本号(如 rustc 1.75.0),则安装成功。

三、安装 Tauri CLI

Tauri CLI 提供项目初始化、开发及构建功能,可通过 npm 或 cargo 安装。

  • 方法一:使用 npm 安装(推荐前端开发者)

    全局安装:在终端运行以下命令:

    npm install -g @tauri-apps/cli

    验证安装:输入以下命令检查版本号:

    tauri --version
  • 方法二:使用 cargo 安装(推荐 Rust 开发者)

    安装命令:在终端运行:

    cargo install tauri-cli

    验证安装:同样通过 tauri --version 检查版本号。

四、环境配置验证

完成上述安装后,需确保所有工具链正常工作:

  1. 检查路径配置

    终端输入 which node(macOS/Linux)或 where node(Windows),确认 Node.js 路径正确。

    类似地检查 rustc 和 cargo 的路径。

  2. 更新工具链(可选)

    Node.js:通过 npm install -g npm@latest 更新 npm。

    Rust:运行 rustup update 更新 Rust 工具链。

五、创建并运行第一个 Tauri 应用

环境准备完成后,可通过以下步骤快速启动项目:

  1. 初始化项目在终端运行:

    tauri init

    按提示填写项目名称、前端框架(如 Vue/React)等配置。

  2. 开发模式运行进入项目目录,执行:

    tauri dev

    终端将显示编译日志,并自动打开应用窗口。

  3. 打包应用开发完成后,运行以下命令生成跨平台安装包:

    tauri build

    生成的安装包位于 src-tauri/target/release/bundle 目录下。

图:Tauri 项目初始化及运行流程六、常见问题解决
  • Node.js 安装失败

    检查系统是否已存在旧版本,先卸载后重新安装。

    确保下载的安装包与操作系统架构匹配(如 64 位系统需下载 x64 版本)。

  • Rust 编译错误

    若提示 linker 错误,需安装构建工具链:

    Windows:安装

    Visual Studio Build Tools

    macOS:运行 xcode-select --install。

    Linux:安装 build-essential(Ubuntu)或 gcc(CentOS)。

  • Tauri CLI 命令未找到

    确认 npm 或 cargo 的全局安装路径已添加到系统环境变量 PATH 中。

    重新打开终端或重启系统使环境变量生效。

通过以上步骤,您已完成 Tauri 2.0 开发环境的全部配置,可开始高效开发跨平台桌面应用。