实现unified-init库,支持收集初始化函数到一个数组,并统一初始化 (#474)

* 添加“统一初始化”的过程宏,并把SystemError独立成crate

* 使用unified-init来初始化fbmem

* 更新workflow,增加内核自动化静态测试
This commit is contained in:
LoGin
2023-12-25 23:12:27 +08:00
committed by GitHub
parent f110d330d5
commit 91e9d4ab55
158 changed files with 1102 additions and 610 deletions

View File

@ -9,4 +9,5 @@
lib_ui/scm
lib_ui/textui
unified-init

View File

@ -0,0 +1,54 @@
# unified-init 统一初始化库
:::{note}
本文作者:龙进 <longjin@DragonOS.org>
2023年12月25日
:::
## 1. 简介
该库位于`kernel/crates/unified-init`中.
提供统一初始化宏,用于将函数注册到统一初始化列表中. 便于统一进行初始化.
需要注意的是初始化器的数组是no_mangle的因此其命名应当遵守`模块_初始化器`的规则,防止重名导致意想不到的错误.
## 2. 用法
```rust
use system_error::SystemError;
use unified_init::define_unified_initializer_slice;
use unified_init_macros::unified_init;
/// 初始化函数都将会被放到这个列表中
define_unified_initializer_slice!(INITIALIZER_LIST);
#[unified_init(INITIALIZER_LIST)]
fn init1() -> Result<(), SystemError> {
Ok(())
}
#[unified_init(INITIALIZER_LIST)]
fn init2() -> Result<(), SystemError> {
Ok(())
}
fn main() {
assert_eq!(INITIALIZER_LIST.len(), 2);
}
```
## 3.开发
需要测试的时候可以在`main.rs`写测试代码,
然后在当前目录执行 `cargo expand --bin unified-init-expand`
就可以看到把proc macro展开后的代码了.
## 4. Maintainer
龙进 <longjin@DragonOS.org>