手把手教你用VFR为UEFI BIOS定制一个漂亮的启动菜单界面
从零打造高颜值UEFI启动菜单：VFR界面开发实战指南
当计算机启动时，那个蓝底白字的传统BIOS界面正在成为过去式。现代UEFI固件允许开发者创建美观、交互性强的图形化界面，而VFR（Visual Forms Representation）正是实现这一目标的核心工具。本文将带你深入UEFI界面开发的世界，从基础概念到实战技巧，一步步构建专业级的启动菜单界面。
1. 认识UEFI界面开发的核心组件
在开始编写代码前，我们需要理解UEFI界面开发的几个关键组成部分。HII（Human Interface Infrastructure）是UEFI中负责用户界面的子系统，它提供了一套完整的框架用于创建和管理界面元素。
核心概念解析：
- VFR文件：可读的文本文件，描述界面结构和布局
- IFR（Internal Forms Representation）：VFR编译后生成的二进制中间格式
- UNI文件：存储多语言字符串资源
- HII数据库：运行时存储所有界面资源的中央仓库
典型的开发流程是：编写VFR和UNI文件 → 使用VFR编译器生成IFR → 通过HII接口将IFR注册到系统 → UEFI Shell或Boot Manager显示界面
提示：EDK II开发环境已经包含了完整的VFR工具链，包括编译器和调试工具，无需额外安装。
2. 搭建开发环境与基础项目结构
要开始UEFI界面开发，首先需要配置合适的开发环境。推荐使用最新的EDK II作为开发框架，它提供了完善的工具链和示例代码。
环境准备步骤：
- 安装Visual Studio（Windows）或GCC（Linux）作为基础编译环境
- 下载EDK II源代码并配置开发环境
- 安装Python 3.x（VFR编译器需要）
- 配置必要的环境变量（如WORKSPACE、EDK_TOOLS_PATH等）
一个典型的UEFI界面项目包含以下文件结构：
MyUefiInterface/ ├── MyUefiInterface.inf # 模块定义文件 ├── MyUefiInterface.c # 主程序逻辑 ├── MyUefiInterface.vfr # 界面描述文件 ├── MyUefiInterface.uni # 多语言字符串资源 └── MyUefiInterface.dsc # 平台配置描述关键配置示例（.inf文件片段）：
[Defines] INF_VERSION = 0x00010005 BASE_NAME = MyUefiInterface FILE_GUID = 3E8B4E4D-9A1F-4D3F-8F2B-1C1A3D4E5F6A MODULE_TYPE = UEFI_DRIVER VERSION_STRING = 1.0 ENTRY_POINT = UefiEntryPoint [Sources] MyUefiInterface.c MyUefiInterface.vfr MyUefiInterface.uni [Packages] MdePkg/MdePkg.dec MdeModulePkg/MdeModulePkg.dec3. 设计启动菜单的VFR结构
现在让我们动手创建一个实际的启动菜单界面。我们将设计一个包含以下元素的界面：
- 顶部横幅（显示系统信息）
- 启动选项列表
- 底部操作按钮区域
基础VFR框架代码：
#define BOOT_MENU_FORMSET_GUID \ {0x3E8B4E4D, 0x9A1F, 0x4D3F, {0x8F, 0x2B, 0x1C, 0x1A, 0x3D, 0x4E, 0x5F, 0x6A}} #define MAIN_FORM_ID 0x1000 #define BOOT_OPTION_LIST_ID 0x1001 #define ACTION_BUTTONS_ID 0x1002 formset guid = BOOT_MENU_FORMSET_GUID, title = STRING_TOKEN(STR_BOOT_MENU_TITLE), help = STRING_TOKEN(STR_BOOT_MENU_HELP), classguid = EFI_HII_PLATFORM_SETUP_FORMSET_GUID { // 主表单 form formid = MAIN_FORM_ID, title = STRING_TOKEN(STR_BOOT_MENU_TITLE); // 系统信息横幅 banner title = STRING_TOKEN(STR_SYSTEM_MODEL), line 1, align left; banner title = STRING_TOKEN(STR_BIOS_VERSION), line 1, align right; // 启动选项列表 subtitle text = STRING_TOKEN(STR_BOOT_OPTIONS); orderedlist varid = BootOrder, prompt = STRING_TOKEN(STR_SELECT_BOOT_OPTION), help = STRING_TOKEN(STR_BOOT_OPTION_HELP), flags = INTERACTIVE, option text = STRING_TOKEN(STR_WINDOWS_BOOT_MANAGER), value = 0x0001, flags = DEFAULT; option text = STRING_TOKEN(STR_UBUNTU), value = 0x0002, flags = 0; option text = STRING_TOKEN(STR_USB_DRIVE), value = 0x0003, flags = 0; endlist; // 操作按钮 subtitle text = STRING_TOKEN(STR_ACTIONS); goto ACTION_BUTTONS_ID, prompt = STRING_TOKEN(STR_ADVANCED_OPTIONS), help = STRING_TOKEN(STR_ADVANCED_OPTIONS_HELP), flags = INTERACTIVE, key = 0x1003; endform; // 高级选项表单 form formid = ACTION_BUTTONS_ID, title = STRING_TOKEN(STR_ADVANCED_OPTIONS); label ACTION_BUTTONS_ID; oneof varid = BootMode, prompt = STRING_TOKEN(STR_BOOT_MODE), help = STRING_TOKEN(STR_BOOT_MODE_HELP), option text = STRING_TOKEN(STR_NORMAL_MODE), value = 0, flags = DEFAULT; option text = STRING_TOKEN(STR_SAFE_MODE), value = 1, flags = 0; option text = STRING_TOKEN(STR_DEBUG_MODE), value = 2, flags = 0; endoneof; checkbox varid = EnableLogging, prompt = STRING_TOKEN(STR_ENABLE_LOGGING), help = STRING_TOKEN(STR_ENABLE_LOGGING_HELP), flags = CHECKBOX_DEFAULT; endcheckbox; endform; } endformset;配套的UNI文件内容：
#langdef en-US "English" #string STR_BOOT_MENU_TITLE #language en-US "Boot Menu" #string STR_BOOT_MENU_HELP #language en-US "Select boot option and configure system settings" #string STR_SYSTEM_MODEL #language en-US "System: %s" #string STR_BIOS_VERSION #language en-US "BIOS: %s" #string STR_BOOT_OPTIONS #language en-US "Boot Options" #string STR_SELECT_BOOT_OPTION #language en-US "Select an option to boot" #string STR_BOOT_OPTION_HELP #language en-US "Use arrow keys to select, Enter to boot" #string STR_WINDOWS_BOOT_MANAGER #language en-US "Windows Boot Manager" #string STR_UBUNTU #language en-US "Ubuntu 22.04 LTS" #string STR_USB_DRIVE #language en-US "USB Drive (SanDisk)" #string STR_ACTIONS #language en-US "Actions" #string STR_ADVANCED_OPTIONS #language en-US "Advanced Options..." #string STR_ADVANCED_OPTIONS_HELP #language en-US "Configure advanced boot settings" #string STR_BOOT_MODE #language en-US "Boot Mode" #string STR_BOOT_MODE_HELP #language en-US "Select system boot mode" #string STR_NORMAL_MODE #language en-US "Normal Mode" #string STR_SAFE_MODE #language en-US "Safe Mode" #string STR_DEBUG_MODE #language en-US "Debug Mode" #string STR_ENABLE_LOGGING #language en-US "Enable Boot Logging" #string STR_ENABLE_LOGGING_HELP #language en-US "Record detailed boot information"4. 高级界面美化技巧
基础功能实现后，我们可以通过一些技巧提升界面的视觉效果和用户体验。
布局优化策略：
- 合理使用空白区域：通过
subtitle和label元素创建视觉分隔 - 对齐控制：利用
align left/right属性使界面元素整齐排列 - 分组相关选项：使用
frame容器将功能相关的控件组织在一起 - 条件显示：通过
suppressif和grayoutif实现动态界面
增强型横幅设计示例：
// 多行系统信息展示 banner title = STRING_TOKEN(STR_SYSTEM_MODEL), line 1, align left; banner title = STRING_TOKEN(STR_CPU_INFO), line 2, align left; banner title = STRING_TOKEN(STR_MEMORY_SIZE), line 2, align right; banner title = STRING_TOKEN(STR_BIOS_DATE), line 3, align left; banner title = STRING_TOKEN(STR_SYSTEM_TIME), line 3, align right;动态界面控制示例：
// 仅当选择了调试模式时显示日志选项 suppressif NOT ideqval BootMode == 2; checkbox varid = DebugLogLevel, prompt = STRING_TOKEN(STR_DEBUG_LOG_LEVEL), help = STRING_TOKEN(STR_DEBUG_LOG_LEVEL_HELP), flags = INTERACTIVE, option text = STRING_TOKEN(STR_LOG_MINIMAL), value = 1, flags = DEFAULT; option text = STRING_TOKEN(STR_LOG_VERBOSE), value = 2, flags = 0; endcheckbox; endif;界面元素对比表：
| 元素类型 | 适用场景 | 交互性 | 示例组件 |
|---|---|---|---|
| 静态元素 | 信息展示 | 无 | banner, label, subtitle |
| 选择控件 | 配置选项 | 高 | checkbox, oneof, orderedlist |
| 操作控件 | 触发动作 | 高 | button, goto |
| 容器元素 | 组织布局 | 无 | form, frame, formset |
5. 编译与调试技巧
完成VFR设计后，需要将其编译并集成到固件镜像中。EDK II的构建系统会自动处理这个过程，但了解底层机制有助于排查问题。
编译流程详解：
- VFR编译器将.vfr文件转换为.c文件（包含IFR数据）
- C编译器将生成的.c文件编译为.obj
- 链接器将所有模块合并为最终固件镜像
- 使用HII工具注册界面资源
常见问题排查指南：
- 编译错误：检查VFR语法，特别是括号匹配和分号
- 界面不显示：确认HII Handle是否正确注册
- 字符串缺失：检查UNI文件是否正确定义并被引用
- 布局错乱：验证元素ID是否唯一，对齐设置是否正确
调试命令示例（UEFI Shell下）：
# 列出所有已注册的HII Handle hii list # 导出特定Handle的IFR内容 hii dump <HandleNumber> -i # 显示字符串数据库 hii dump <HandleNumber> -s注意：在实际开发中，建议使用QEMU等模拟器进行初步测试，避免频繁刷写物理设备。
6. 性能优化与最佳实践
随着界面复杂度的增加，性能优化变得尤为重要。以下是提升UEFI界面响应速度的几个关键策略：
- 最小化IFR大小：精简不必要的界面元素，合并相似功能
- 延迟加载：将不常用的功能放到二级菜单
- 缓存常用数据：减少对NVRAM的频繁访问
- 优化字符串资源：只包含实际使用的字符串
资源占用对比示例：
| 优化策略 | 原始大小 | 优化后大小 | 节省比例 |
|---|---|---|---|
| 合并相似表单 | 12KB | 8KB | 33% |
| 移除未使用字符串 | 6KB | 4KB | 33% |
| 使用动态加载 | 20KB | 12KB | 40% |
推荐的开发工作流：
- 在模拟器中快速原型设计
- 使用调试工具验证界面行为
- 在物理设备上进行性能测试
- 收集用户反馈并迭代优化
7. 扩展功能与进阶主题
掌握了基础开发技能后，可以进一步探索UEFI界面开发的高级特性：
动态界面生成：通过Protocol动态修改IFR结构，实现完全可定制的界面。例如，可以根据检测到的硬件动态生成启动选项。
EFI_STATUS UpdateBootOptions ( IN EFI_HII_HANDLE HiiHandle, IN UINT16 FormId ) { EFI_IFR_ORDERED_LIST *ListOpCode; EFI_IFR_ONE_OF_OPTION *OptionOpCode; // 创建新的有序列表操作码 ListOpCode = BuildOpCode(EFI_IFR_ORDERED_LIST_OP, sizeof(EFI_IFR_ORDERED_LIST)); ListOpCode->QuestionId = BOOT_OPTION_LIST_ID; ListOpCode->Width = 50; // 添加动态检测到的启动选项 for (UINTN i = 0; i < DetectedBootOptionCount; i++) { OptionOpCode = BuildOpCode(EFI_IFR_ONE_OF_OPTION_OP, sizeof(EFI_IFR_ONE_OF_OPTION)); OptionOpCode->Option = GetStringToken(DetectedBootOptions[i].Description); OptionOpCode->Value = DetectedBootOptions[i].Id; OptionOpCode->Flags = DetectedBootOptions[i].IsDefault ? DEFAULT : 0; AppendOpCode(ListOpCode, OptionOpCode); } // 更新HII数据库 return HiiUpdateForm(HiiHandle, FormId, ListOpCode, ...); }多主题支持：通过扩展VFR语法和自定义渲染引擎，实现暗黑模式、高对比度等不同视觉主题。
触摸优化：针对支持触摸屏的设备，设计适合手指操作的界面元素大小和布局。
本地化扩展：超越简单的字符串替换，实现符合不同地区文化习惯的完整本地化方案，包括布局镜像（RTL语言）、日期时间格式等。