OpenCore Configurator 使用指南

1. 项目简介

OpenCore Configurator 是一款图形化工具，用于创建和编辑 OpenCore 引导加载器配置文件，简化黑苹果系统的配置流程。

2. 技术背景

2.1 开发基础

项目采用 Swift 5 开发，需 Xcode 10.2 及以上版本构建。核心功能依赖 Cocoa 框架实现 macOS 原生界面，集成 macserial 工具生成 SMBIOS 信息。

2.2 核心技术栈

• OpenCore：开源引导加载器，支持非苹果硬件运行 macOS
• Swift 5：现代编程语言，提供类型安全和高性能
• macserial：SMBIOS 信息生成工具，用于硬件配置模拟
• Cocoa：macOS 应用开发框架，提供完整的 UI 组件库

3. 环境准备

3.1 系统要求

• macOS 10.14+ 操作系统
• Xcode 10.2 或更高版本
• 至少 2GB 可用存储空间

3.2 工具准备

1. 安装 Xcode 开发工具
2. 获取项目源码
3. 准备 macserial 二进制文件

4. 实施步骤

4.1 源码获取与配置

1. 克隆项目代码库到本地
2. 将 macserial 二进制文件放置于项目根目录
3. 双击 OpenCore Configurator.xcodeproj 文件打开项目

4.2 项目构建与运行

1. 在 Xcode 中选择 Product > Build 构建项目
2. 构建完成后，选择 Product > Run 启动应用
3. 首次运行可能需要在系统偏好设置中允许开发者应用运行

4.3 基本使用流程

1. 通过应用界面导航至配置文件所在位置
2. 使用图形化界面编辑各项配置参数
3. 保存配置文件到 EFI 分区指定目录

5. 常见问题

5.1 构建失败

问题：Xcode 提示"macserial not found"
解决：确认 macserial 二进制文件已放置在项目根目录，且文件名正确无误

5.2 应用无法启动

问题：启动后立即退出或无响应
解决：检查 Xcode 版本是否符合要求，尝试清理项目缓存（Product > Clean Build Folder）后重新构建

5.3 配置文件不生效

问题：保存的配置未应用到系统
解决：验证 EFI 分区挂载是否正确，确保配置文件保存路径为/EFI/OC/config.plist

5.4 硬件识别异常

问题：SMBIOS 信息无法生成
解决：检查 macserial 文件权限，终端执行chmod +x macserial赋予执行权限

6. 功能特点

6.1 核心功能

• 支持 ACPI 补丁导入（OC/Clover 格式）
• 自动添加 ACPI 表、KEXT 和 UEFI 驱动条目
• 验证文件完整性（ACPI 表、KEXT、UEFI 驱动）
• 集成 EFI 分区挂载工具

6.2 即将推出功能

• Clover 配置文件转换为 OpenCore 格式
• 应用内更新功能（含 macserial 自动更新）