技术参考
从这里查找一次修改对应的文件、操作步骤和验证方法。完整流程见移植设备和构建与启动;板级参数与当前结果见设备列表。
1. 找到配置或实现
| 修改内容 | 文件或实现 | 操作步骤 |
|---|---|---|
| 本地输入路径 | 主仓库 unixnu.local.toml | 配置构建输入 |
| 设备、SoC 或组件选择 | 设备 board.toml、feeds.toml、configs/ | 解析设备配置 |
| 硬件资源 | SoC DTSI 和板级 DTS | 设备树 |
| 驱动行为 | 所选组件或设备 package | 适配硬件、开发驱动 |
| 内核行为 | 所属 profile 或组件的补丁序列 | 修改 XNU |
| XNU 启动参数 | [payload] kernel_args 或本地 [build] kernel_args | 应用启动参数 |
| 启动菜单或 kit | payload 的 EFI/UniXNU/unixnu.toml、kit 的 Kit.toml | 启动配置 |
| 设备支持记录 | 设备 porting.toml 与主仓库 devices.toml | 更新和发布记录 |
| 文档 | 主仓库 docs/ 中英文页面 | 编辑和发布文档 |
完成结果: 编辑前确定文件归属和对应操作步骤。
2. 查阅对应规范
| 内容 | 参考文档 |
|---|---|
| 构建工具 | 命令与参数、配置字段、输出路径与报告 |
| 组件 | 组件目录与源码身份、仓库和组件页面 |
| 驱动接口 | UEFI 驱动、内置 XNU 驱动、kext 包、设备树匹配 |
| XNU | 源码与补丁归属、补丁目录、4 KiB 页表 |
| 启动与镜像格式 | 启动链、预链接、payload、userdata 布局、启动配置 |
| 完整性 | trust cache 与启动策略 |
| 项目结构 | 仓库归属、术语 |
字段表列出可用值和路径,操作顺序与构建命令见对应步骤链接。
3. 验证受影响的输出
在主仓库中选定目标设备,运行:
sh
./unixnu status --json核对设备、OS profile、配置、模块来源和输出目录,再执行对应验证:
| 改动 | 验证方法 | 预期结果 |
|---|---|---|
| 内核、驱动或补丁 | 构建内核,再按启动验证顺序检查 | 内核与预链接成功,受影响的设备检查点单独记录 |
| 固件或 payload | 构建与启动 | 更新的 FD、payload 和启动镜像使用指定输入 |
| 启动参数 | 检查 payload 配置 | 打包后的 args 与预期命令行一致 |
| 公共 UEFI 行为 | QEMU 操作步骤 | 所选场景出现预期日志标记 |
| 适配记录或文档 | 记录检查、站点构建 | 记录验证和文档构建通过 |