固件操作系统【免费下载链接】CloverBootloaderBootloader for macOS, Windows and Linux in UEFI and in legacy mode项目地址https://gitcode.com/gh_mirrors/cl/CloverBootloader点击查看免费下载导读EDK IIUEFI 固件开发环境的构建体系并非只有 C 语言编译器它还依赖一批基于 Python 编写的辅助工具如Trim、GenFds、UPT、PatchPcdValue等它们长期以源码形式内嵌在 BaseTools 目录树中。本仓库CloverBootloader一个面向 macOS / Windows / Linux 的 UEFI 与 Legacy 模式引导程序其构建体系完整继承了 EDK II 的 BaseTools中的 BaseTools/Source/Python/README.md 记录了这批 Python 工具的定位、迁移去向与安装方式。阅读本文后你将理解 EDK II 构建链中Python 工具层的作用边界、它为何被拆分为独立分发的 pip 包以及如何通过pip install或本地克隆方式安装与使用这些工具。一、目录定位BaseTools 中的Python 工具层EDK II 的 BaseTools 分为两个执行形态一部分是 C 源码编译出的原生可执行文件如GenFv、GenFfs、EfiRom等见 BaseTools/ReadMe.txt另一部分则是本节主题——基于 Python 编写的工具源码。BaseTools/Source/Python/README.md 开篇即明确了该目录的定位它传统上一直存放着 EDK II 构建体系所使用的各类 Python 工具源码This folder has traditionally held the source of Python based tools used by EDK2。从当前仓库的实际目录结构看这套源码布局完整保留按工具名划分的子目录包括Trim/——处理编译器预处理产物.i文件与 ASL 文件的文本处理工具GenFds/——FDSFlash Description File生成器负责把固件卷描述编译为实际固件布局AutoGen/——自动生成模块的AutoGen.c/AutoGen.h等构建辅助代码UPT/——UEFI Package Tool用于安装、替换、删除 EDK II 包含InstallPkg.py、ReplacePkg.py、RmPkg.py、MkPkg.py等子命令BPDG/、PatchPcdValue/、GenPatchPcdTable/——围绕 PCDPlatform Configuration Database的生成与修补工具Capsule/、Pkcs7Sign/、Rsa2048Sha256Sign/——固件胶囊与签名相关工具Ecc/、Eot/——代码规范检查与工程对象浏览工具Split/、TargetTool/、Table/、Workspace/、Common/、CommonDataClass/等——通用组件与支撑库。此外还包含sitecustomize.pyPython 启动时自动加载的站点定制脚本内容为当运行在 darwin 平台且为 Python 2 时用locale.getdefaultlocale()兜底设置默认编码见 sitecustomize.py以及tests/测试目录如 tests/Split/ 下存放的 Split 工具测试用例。二、迁移背景为什么要把这些工具拆出去原文档的 Why Move It? 一节直接交代了这批 Python 工具从 EDK II 主仓库拆分的动机其核心诉求可以归纳为四条独立复用让 BaseTools尤其是 Python 部分能够脱离 EDK II 主仓库单独使用从而以全局可访问的方式被其他项目引用简化模块构建开发者构建单个模块module时不必再依赖整套 EDK II 源码树只要拿到独立的 BaseTools 即可更顺畅的 CI 与贡献流程工具与固件源码分离后各自拥有独立的持续集成和评审通道工具侧的改动不必再等待固件主线的节奏版本绑定更明确工具以独立仓库 pip 包形式发布EDK II 主仓库通过版本清单pip-requirements.txt锁定并测试特定版本保证构建环境可复现。同时文档给出了一个明确的过渡安排BaseTools/Source/Python目录会保留在 EDK II 源码树中直到下一个稳定版本发布文档预期为 202102 版。从当前仓库快照看该目录及其完整工具源码仍被保留——这也正是本文能以仓库源码为据展开介绍的原因。三、仓库中的实际形态BinWrappers 与从源码直接运行在迁移尚未完成、或需要使用内嵌源码版本时这些 Python 工具并非要求开发者手动拼 Python 命令而是通过 BaseTools 提供的**包装脚本wrapper**间接调用。理解这一机制是读懂本目录价值的关键。3.1 包装脚本如何工作以 BaseTools/BinWrappers/PosixLike/Trim 为例脚本核心逻辑为# 若设置了 ${PYTHON_COMMAND}则优先使用它作为 Python 解释器 if command -v ${PYTHON_COMMAND} /dev/null 21; then python_exe${PYTHON_COMMAND} fi ... # 关键把 Source/Python 加入 PYTHONPATH随后调用同名子目录下的 .py 入口 export PYTHONPATH$dir/../../Source/Python${PYTHONPATH::$PYTHONPATH} exec ${python_exe:-python} $dir/../../Source/Python/$exe/$exe.py $这段脚本揭示了三个事实工具入口统一约定为Source/Python/工具名/工具名.pyTrim对应Trim/Trim.pyUPT对应UPT/UPT.py见 BinWrappers/PosixLike/UPT脚本将Source/Python注入PYTHONPATH使各工具可以import Common.*这类共享模块如 Trim/Trim.py 中的import Common.LongFilePathOs as os、from Common.Misc import *通过PYTHON_COMMAND环境变量可指定具体 Python 解释器版本未设置时回退到python。Windows 侧提供等价实现见 BaseTools/BinWrappers/WindowsLike/ 下的Trim.bat、UPT.bat、GenFds.bat、Ecc.bat等 14 个批处理包装脚本。3.2 PosixLike 下可用的工具清单BaseTools/BinWrappers/PosixLike/ 目录共提供 30 个工具入口其中 Python 工具占据大多数包括包装脚本对应 Python 工具用途概述TrimTrim.py清理编译器预处理输出、处理 ASL IncludeGenFdsGenFds.py依据 FDF 文件生成固件卷/固件文件GenPatchPcdTableGenPatchPcdTable.py生成 Patchable PCD 表PatchPcdValuePatchPcdValue.py在二进制文件中修补 PCD 值GenDepexGenDepex.py生成模块依赖表达式BPDGBPDG.py生成二进制 PCD 数据EccEcc.pyEDK II 代码规范检查器EotEot.py工程对象浏览UPTUPT.pyUEFI 包安装/替换/删除Pkcs7SignPkcs7Sign.pyPKCS7 签名Rsa2048Sha256SignRsa2048Sha256Sign.pyRSA-2048/SHA-256 签名Rsa2048Sha256GenerateKeys对应生成密钥工具RSA-2048/SHA-256 密钥对生成SplitSplit.py按指定偏移拆分二进制文件TargetToolTargetTool.py目标平台信息查询工具GenerateCapsuleCapsule 工具生成固件更新 Capsule其余如VfrCompile、EfiRom、GenFv、GenFfs、GenSec、GenFw、GenPage、TianoCompress、LzmaCompress、LzmaF86Compress、Brotli、BrotliCompress、DevicePath、VolInfo、EfiLdrImage则对应 C 编译产物属于 BaseTools 的 C 工具层。3.3 一个具体的工具示例Split以 Split/Split.py 为例可直观感受这批工具的 CLI 风格argparse 实现-f/--filename 待拆分的输入文件必填 -s/--split 第一段文件的字节数支持 HEX、十进制及十进制[KMG] 后缀必填 -p/--prefix 输出目录 -o/--firstfile 第一个输出文件名 -t/--secondfile 第二个输出文件名 -v/--verbose 输出调试信息与 -q 互斥 -q/--quiet 静默模式仅报告致命错误 --version 打印版本信息Version 2.0其配套测试位于 BaseTools/Source/Python/tests/Split/可作为验证工具行为的参考。类似地Trim/Trim.py 通过一组正则表达式如匹配#line xxx行控制指令的gLineControlDirective、匹配十六进制/十进制/U/LL后缀数值常量的数字模式、匹配 ASLInclude()与 C 风格#include的模式完成对编译器预处理输出的清洗与格式转换——这正是固件编译链中承上启下的一环。四、安装方式从 pip 包到本地克隆原文档 How Do I Install It? 一节给出了三种安装路径构成从源码树到独立 pip 包迁移落地后的标准做法。4.1 方式一通过 pip 安装绑定版本推荐上游 EDK II 默认通过根目录的pip-requirements.txt将构建环境绑定并测试到某个特定版本的 BaseTools安装命令为pip install -r pip-requirements.txt执行后pip 会按清单解析并安装对应版本的edk2-basetools模块。原文档同时强烈建议安装前先创建 Python 虚拟环境virtual environment以避免与系统级 Python 包互相污染。需要说明的是pip-requirements.txt属于上游 EDK II 源码树的文件当前仓库CloverBootloader并未包含该清单若在本仓库内构建应参照上游 EDK II 的版本绑定实践自行创建等价的 requirements 清单或直接安装指定版本。4.2 方式二安装本地克隆如果你手头已有 BaseTools 的独立仓库克隆可以直接将本地路径交给 pippip install 本地克隆路径这种方式适合在工具仓库自身迭代调试时使用让本地的edk2-basetools源码直接参与当前 Python 环境的解析。4.3 方式三安装指定 git commit由于工具仓库与固件主线是独立演进的两个仓库构建的可复现性要求版本精确到提交pip install 仓库URLcommit-id在后指定确切的 git 提交号commit即可锁定某次工具改动。这一做法与EDK II 通过版本清单锁定 BaseTools 版本的理念一脉相承任何一次构建工具层的版本都应可精确复现。五、与BinPipWrappers的衔接作用域切换机制原文档还描述了一个重要的切换机制BaseTools 下新增了BinPipWrappers目录它不再指向Source/Python树内的源码而是直接使用 pip 安装的edk2-basetools模块。切换方式是通过构建时传入的作用域scope参数完成在 Windows 主机上使用作用域pipbuild-win在类 Unix 主机上使用作用域pipbuild-unix当构建环境SDE即 Standalone Development Environment检测到对应作用域被启用时会自动改用BinPipWrappers中的包装脚本而不再使用常规的BinWrappers——也就是说同一条构建命令在两种模式下分别消费源码树内的工具与pip 模块中的工具从而实现对迁移过渡期的平滑支持老环境继续用内嵌源码新环境用独立 pip 包。从当前仓库结构看BinWrappersPosixLike/ 与 WindowsLike/仍然完整保留而BinPipWrappers目录未出现在本快照中——这与文档目录保留至下一个稳定版本预期 202102的过渡安排一致说明当前仓库仍处于源码树内嵌 常规 BinWrappers阶段。六、在 CloverBootloader 中继续使用内嵌 Python 工具对于当前仓库CloverBootloader的构建与二次开发可以在不引入 pip 包的前提下直接使用这套内嵌工具建议路径如下设置环境变量参照 BaseTools/ReadMe.txt 对 EDK II BaseTools 的通用约定EDK_TOOLS_PATH指向 BaseTools 子目录BASE_TOOLS_PATH指向 BaseTools 源码所在目录确保BinWrappers/PosixLike类 Unix或BinWrappers/WindowsLikeWindows在PATH中之后即可直接调用Trim、GenFds、UPT等命令需要指定 Python 解释器时提前导出PYTHON_COMMAND环境变量例如指向 Python 3 的可执行文件包装脚本会自动优先采用想跳过包装脚本直接运行时可手工复刻脚本行为export PYTHONPATH$PWD/BaseTools/Source/Python python BaseTools/Source/Python/Trim/Trim.py --help清理 Python 缓存若对工具代码做过本地迭代可用 BaseTools/Source/Python/GNUmakefile 提供的make clean清掉目录树下的*.pyc产物。七、小结以 BaseTools/Source/Python/README.md 为纲可以把 EDK II BaseTools 的 Python 工具层概括为三个阶段的事实现状本仓库快照BaseTools/Source/Python仍完整内嵌各工具通过BinWrappers包装脚本以设置 PYTHONPATH 调用同名 .py 入口的方式运行Windows 与类 Unix 均有对应包装迁移方向这批工具将独立为可全局分发的 pip 包edk2-basetools通过pipbuild-win/pipbuild-unix作用域在BinPipWrappers与常规BinWrappers之间切换安装方式pip install -r pip-requirements.txt绑定版本建议配合虚拟环境、安装本地克隆、或安装指定 git commit三种方式共同保证工具层版本可复现。理解这条从内嵌源码到独立 pip 包的演进脉络有助于在 CloverBootloader 等 EDK II 系项目中正确选择工具获取方式、排查构建环境差异并在未来迁移到 pip 化 BaseTools 时平稳过渡。赞分享固件操作系统【免费下载链接】CloverBootloaderBootloader for macOS, Windows and Linux in UEFI and in legacy mode项目地址https://gitcode.com/gh_mirrors/cl/CloverBootloader点击查看免费下载相关推荐EMQX 插件开发完全指南从 monorepo 内嵌开发到独立仓库打包EMQX 插件开发完全指南从 monorepo 内嵌开发到独立仓库打包 导读 EMQX 是一个基于 Erlang/OTP 应用集合构建的 MQTT 消息服务器后端物联网消息队列通信从安装到把 PDF 表格提取成数据pdfplumber 上手指南从安装到把 PDF 表格提取成数据pdfplumber 上手指南 手头的月报是 20 页 PDF你要把其中带边框的表格原样搬进 Excel。手动复制又慢又容数据分析文档Docling 仓库内嵌 Pydantic AI 技能参考函数工具、工具集与 MCP 服务器的组织实战Docling 仓库内嵌 Pydantic AI 技能参考函数工具、工具集与 MCP 服务器的组织实战 本篇围绕 Docling 仓库中随仓分发的开发技能参考AI 应用计算机视觉OCR上一篇开机 45 秒右键卡两秒windows-defender-remover 彻底卸载 Windows Defender把老电脑跑回从前下一篇GitHub 中文化插件完全新手指南3 步 5 分钟把整个界面变中文创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考