Boot2Rust 项目启动与配置教程

Boot2Rust 项目启动与配置教程

Boot2Rust EFI applications in Rust 项目地址: https://gitcode.com/gh_mirrors/bo/Boot2Rust

1. 项目目录结构及介绍

Boot2Rust 是一个用 Rust 语言编写的 EFI 应用程序项目。以下是项目的目录结构及其简要介绍：

Boot2Rust/
├── .gitmodules          # 定义子模块的git仓库信息
├── .gitignore           # 指定git应该忽略的文件和目录
├── LICENSE              # 项目许可证信息
├── Makefile             # 构建项目所需的Makefile
├── src/                 # 源代码目录
│   └── main.rs          # 主程序文件
└── target/              # 构建产物目录

• .gitmodules: 这个文件用于声明本项目依赖的外部子模块，例如编译所需的工具链。
• .gitignore: 此文件列出了在执行 git 操作时应该被忽略的文件和目录，以避免将不必要的文件提交到版本控制系统中。
• LICENSE: 包含了项目的许可证信息，本项目采用 MIT 许可证。
• Makefile: 定义了构建项目所需的步骤和规则。
• src/: 源代码目录，包含了项目的主要代码。
  • main.rs: Rust 程序的入口点，所有的 EFI 应用程序的逻辑都在这个文件中实现。
• target/: 构建产物目录，所有的编译输出都会存放在这里。

2. 项目的启动文件介绍

项目的启动文件是位于 src/ 目录下的 main.rs 文件。以下是 main.rs 的基本结构：

#![no_std]
#![no_main]

extern crate alloc;

use alloc::string::String;
use uefi::prelude::*;

fn main() {
    // 初始化UEFI环境
    let system_table = boot_services().system_table();
    let stdout = system_table.stdout();

    // 向控制台输出信息
    writeln!(stdout, "Hello, UEFI!").unwrap();
}

在这个文件中：

• #![no_std] 和 #![no_main] 是编译器属性，它们告诉编译器不要使用标准库和不要使用默认的入口点。
• extern crate alloc; 声明了一个外部依赖，这里是 alloc crate，它提供了许多基础的通用功能。
• use alloc::string::String; 引入了用于创建和管理字符串的 String 类型。
• use uefi::prelude::*; 引入了UEFI相关的预导入模块，这些模块简化了UEFI应用程序的编写。
• main() 函数是程序的入口点，在这里我们初始化UEFI环境，并通过 writeln! 宏向控制台输出信息。

3. 项目的配置文件介绍

本项目的主要配置文件是 Makefile。这个文件定义了构建项目所需的规则和步骤。以下是一些基本的配置：

RUSTC := rustc
RUST_FLAGS := -C opt-level=3
TARGET := x86_64-unknown-uefi

all: build

build:
	$(RUSTC) $(RUST_FLAGS) src/main.rs --crate-type bin --target $(TARGET) -o target/uefi_app.efi

clean:
	rm -rf target/

在 Makefile 中：

• RUSTC 变量定义了用于编译 Rust 代码的编译器。
• RUST_FLAGS 设置了编译时使用的标志，例如优化等级。
• TARGET 设置了编译目标，这里是 x86_64-unknown-uefi，意味着我们将为UEFI环境构建64位应用程序。
• all 目标是默认的构建目标，它依赖于 build 目标。
• build 目标使用 rustc 命令来编译 main.rs 文件，并生成可在UEFI环境中运行的 uefi_app.efi 文件。
• clean 目标用于清理项目，它会删除 target/ 目录，其中包含了所有的构建产物。

Boot2Rust EFI applications in Rust 项目地址: https://gitcode.com/gh_mirrors/bo/Boot2Rust