工具链安装

Rust 安装

确保你已经安装了 Rust。如果没有,请参阅 rustup 网站上的说明。

[!WARNING] 使用基于 Unix 的系统时,通过系统的包管理器(例如 brew、apt、dnf 等)安装 Rust 可能导致各种问题和兼容性冲突,因此最好使用 rustup。

使用 Windows 时,请确保你已安装下面列出的 ABI 之一。有关更多详细信息,请参阅 The rustup book 中的 Windows 章节。

  • MSVC:推荐的 ABI,包含在 rustup 的默认依赖项列表中。使用此 ABI 可以与 Visual Studio 生成的软件实现互操作。

    如果不确定该选哪个,就使用它。

  • GNU:GCC 工具链使用的 ABI。你可以自行安装它,以便与使用 MinGW/MSYS2 工具链构建的软件实现互操作。

另请参阅其他安装方案。

RISC-V 设备

要为基于 RISC-V 架构的乐鑫芯片构建 Rust 应用程序(如果不确定设备采用哪种架构,请参阅硬件概览),请执行以下步骤:

  1. 安装适当的工具链以及 rust-src 组件:

    • 既可以使用 stable,也可以使用 nightly:
      rustup toolchain install stable --component rust-src
      
      或
      rustup toolchain install nightly --component rust-src
      

    [!NOTE] rustfmt、clippy 和 rust-analyzer 等其他组件并非必需,但强烈推荐安装。

  2. 安装目标:

    rustup target add riscv32imc-unknown-none-elf # For ESP32-C2 and ESP32-C3
    rustup target add riscv32imac-unknown-none-elf # For ESP32-C6 and ESP32-H2
    

    这些目标目前属于 Tier 2。注意 Rust 中不同的 riscv32 目标包含了不同的 RISC-V 扩展。

如果你_不打算_使用 ESP32、ESP32-S2 或 ESP32-S3,工具链安装就已经完成,可以跳到工具安装章节。

Xtensa 设备

如硬件概览所述,ESP32、ESP32-S2 和 ESP32-S3 采用 Xtensa 架构。如果要为这些芯片开发,目前需要使用 Rust 编译器的分支版本。

espup 是一款工具,用于简化为这些目标开发 Rust 应用程序所需的工具链安装和维护过程。

  1. 安装 espup:
    cargo install espup --locked
    
    也可以直接下载预编译好的发行二进制文件,或使用 cargo-binstall。
  2. 运行以下命令,为所有受支持的乐鑫目标安装全部必需的工具链:
    espup install
    
  3. 在 Unix 系统上配置环境变量:请参阅 espup README 中介绍的不同方法。Windows 用户无需进行其他操作。

espup 安装了什么

为了启用对乐鑫目标的支持,espup 安装了以下工具:

分支编译器能与标准 Rust 编译器共存,允许在一个系统上同时安装两者。可以使用任意一种 override 方法来调用分支编译器。