一键生成黑苹果 OpenCore EFI 文件：OC.Gen

看见就非常 2022-01-18

展开全文

概述

本文最后更新：2021年5月11日

OC.Gen-X 是一款主要由 Pavo-IM Pavo 开发的小工具，用于一键生成适用于 OpenCore 的 EFI 引导文件夹（各项设置基于 Dortania 的 OpenCore 安装指南）。不过该 app 需要 macOS 环境才能运行，没有的用户可以先使用虚拟机安装 macOS（macOS 10.15 即可），配置好 EFI 文件夹后可以通过刻录镜像的方式安装 macOS，基础安装教程可参考此链接。

截止目前，该软件支持以下硬件平台：

英特尔
- 消费级
  - Ivy Bridge（第三代酷睿）
  - Haswell 和 Broadwell（第四、五代酷睿）
  - Skylake（第六代酷睿）
  - Kaby Lake（第七代酷睿）
  - Coffee Lake（第八、九代酷睿）
  - Comet Lake（第十代酷睿）
- HEDT 平台
  - Haswell-E（第五代酷睿 X99 平台）
  - Broadwell-E（第六代酷睿 X99 平台）
  - Skylake-X/W 和 Cascade Lake-X/W（第七、九、十代酷睿 X 系列和 Xeon 系列）
AMD
- Ryzen Zen/Zen2（锐龙和 Threadripper 线程撕裂者）
- Proxintosh（Qemu+KVM）
- Gen 3 Threadripper（TRX40）
软件更新频率很高，一般情况下默认支持 OpenCore 最新版本

接下来本文将指导如何使用这款软件生成 OpenCore EFI 引导文件，本文默认你拥有并正在使用 macOS 环境。

OpenCore 是什么？

目前黑苹果安装主要通过使用 EFI 引导程序（Bootloader）的方法，现在较为流行的有 Clover 和 OpenCore。Clover 从变色龙时代进化而来，背负了很多沉重的历史包袱，为兼容性做出了各种妥协。OpenCore 在设计之初理念就较为先进，并且丢掉了不少 Clover 的历史包袱，轻装前行。理论上 OpenCore 可以正确引导所有基于 UEFI 技术的现代操作系统，也就是常见的 Windows、Linux、macOS 都是能被支持的，但目前 OpenCore 应用最多的就是黑苹果的安装使用。

OpenCore 的优势：

由 acidanthera 团队主导开发的黑苹果驱动已经全面转向 OpenCore，例如声卡 AppleALC、显卡 WhateverGreen、核心扩展 Lilu 等等，均不再测试 Clover 的兼容性，这些驱动是使用黑苹果必不可少的；
一般来说，OpenCore 系统的启动速度比使用 Clover 的系统快；
支持 UEFI 和传统启动引导模式（Legacy）；
Mask Patching 意味着 macOS 的更新几乎不会破坏基于 AMD 的黑苹果系统，而 OpenCore 拥有的 AMD OSX Patches 支持 High Sierra，Mojave 和 Catalina 的所有版本。

OpenCore 其它方面的优势这里不再赘述，目前已经有足够多的 OpenCore 教程和资料，黑苹果星球不再重复造轮子，下面的链接都非常有参考价值：

OpenCore 官方文档（英文）
OpenCore 官方文档迭代（根据版本标记修改，英文）
OpenCore 简体中文参考手册
Dortania 的 OpenCore 安装指南（之前称为 khronokernel OpenCore Vanilla Guide，英文）
从 Clover 到 OpenCore：Clover 迁移 OpenCore 指南 by Sukka
精解 OpenCore by 黑果小兵
使用 OpenCore 引导黑苹果 by Xjn
OpenCore SSDT 补丁库：OC-little
OpenCore OC-little 部件补丁在线手册
Getting Started With ACPI（英文）

更多 OpenCore 详解，请参阅：一步一步从零迁移到 OpenCore。

一键生成 OpenCore EFI 文件

接下来，我们运行 OC.Gen-X，根据自己的硬件平台勾选对应的设置，演示机型配置如下表：

配件	品牌	型号	数量	备注
CPU	英特尔	i9-9900k	1
主板	华硕	ROG Maximus X Hero	1	Z370
内存	美商海盗船	复仇者 DDR4 8GB 3000MHz	4	支持X.M.P
显卡	AMD	RX 5700XT 50周年纪念版	1
硬盘	西部数据	SN750 1TB	1
蓝牙&WiFi	奋威	FV-T919	1	BCM94360CD

下面根据演示机型进行配置，见图：

更新：绝大多数台式机无需 SMCLightSensor（光传感器），如果是内置了光传感器的一体机可以勾选，遇到问题请取消。

2020年11月29日更新：2.7.0 以上版本集成了 AGPMInjector.app，生成的 kext 用于控制独显功耗等功能，照下图逻辑操作即可。

关于 SMBIOS：

这个可以理解成白苹果电脑的机型 ID，不同的标识符对应不同的白苹果产品线，数字则代表是第几代及其它配置区别，例如 iMac19,1 是一体机，Macmini8,1 是迷你机，MacPro7,1 是~~刨丝器~~专业工作站。
明白了上一点，接下来就容易理解了：黑苹果其实就是抄作业，使用相同或近似的硬件配置来仿冒白苹果机型，欺骗 macOS 让它以为自己运行在真正的 Mac 上，从而达到“黑”的目的（当然机型 ID 只是其中一环)。
如何选择适合你的 SMBIOS ID，请参阅：SIMBIOS ID、Platform-ID速查表。
如果你想把三个空都一并填了，请参阅：给黑苹果注入三码。

参数解释：

-v 用于打开跑码模式，方便排错；
debug=0x100 用于发生严重错误（Kernel Panic）后禁止自动重启，将停留在出错位置，方便排错；
keepsyms=1 用于辅助上一个启动参数，可以对错误原因提供更多有用的信息；
agdpmod=pikera 用于解决 Navi 核心的显卡启动黑屏问题，如果你是 Polaris(RX400/RX500) 或 Vega(56/64) 显卡则无需此项；
使用 Nvidia 显卡请添加 nvda_drv=1；
笔记本如需关闭独显请添加 -wegnoegpu；
X99、X299 平台以及部分 AMD 平台需要添加 npci=0x2000 或 npci=0x3000，当跑代码卡在 PCI Start Configuration 时使用；
- 只有 AMD 平台的 BIOS 没有 Above 4G Decoding 选项时添加此参数，二者不可同时使用。
alcid=11 是 AppleALC.kext 用于驱动声卡的参数，演示机型板载 ALC1220 芯片，可使用 layout-id 11 驱动声卡，其它芯片可参考 AppleALC.kext 提供的解码器支持表单和驱动更新日志。