从模板生成项目
我们目前维护了两个模板仓库:
esp-generate-no_std模板。esp-idf-template-std模板。
esp-generate
esp-generate 是一个项目生成工具,可用于生成包含所有必需配置和依赖项的应用程序
-
安装
esp-generate:cargo install esp-generate -
基于模板生成项目,选择芯片和项目名称:
esp-generate --chip=esp32c6 your-project参见
esp-generate简介了解模板项目的更多详细信息。调用
esp-generate子命令时,它会提示一个 TUI,你可以在其中选择应用程序的配置。完成此过程后,你将获得一个配置正确且可构建的项目。 -
构建/运行生成的项目:
- 用
cargo build编译项目(使用合适的工具链和目标)。 - 用
cargo run编译项目、向目标设备烧写程序、并开启一个串口监视器。
- 用
esp-idf-template
esp-idf-template 基于 cargo-generate,这是一个允许你基于现有模板创建新项目的工具。在我们的场景中,esp-idf-template 可用于生成包含所有必需配置和依赖项的应用程序。
-
安装
cargo generate:cargo install cargo-generate -
基于模板生成项目:
cargo generate esp-rs/esp-idf-template cargo参见
esp-idf-template简介了解模板项目的更多详细信息。调用
cargo generate子命令时,它会询问几个关于应用程序目标的问题。完成这些问题后,就会生成一个配置好的项目,可以直接构建。 -
构建/运行生成的项目:
- 用
cargo build编译项目(自动使用合适的工具链和目标)。 - 用
cargo run编译项目、向目标设备烧写程序、并开启一个串口监视器。
- 用
在模板中使用开发容器(Dev Container)
两个模板仓库都支持开发容器。
开发容器使用 idf-rust 镜像,配置开发环境中的使用容器一节对此进行了解释。这个镜像提供了一个无需安装即可为乐鑫芯片开发 Rust 应用程序的环境。开发容器还可以与 Wokwi 模拟器协作,以模拟项目,并允许使用 web-flash 从容器中进行烧写。