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

黑酱 2020-08-29 教程软件

概述

本文最后更新：2022年4月26日

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 提供的解码器支持表单和驱动更新日志。

现在，生成的 EFI 文件夹会出现在你的桌面，见图：

添加 SSDT

OC.Gen-X 默认不会添加任何 SSDT 文件，但大部分硬件配置正常运行 OpenCore 是需要 SSDT 文件的。所以，根据硬件配置的不同，还需要添加 OpenCore 适配的 SSDT 文件，否则一定会卡在跑码启动阶段。

Intel 桌面端

AMD 桌面端

Intel HEDT 平台

上述链接中的内容可使用 MaciASL.app 直接编译为 .aml 文件，也可直接下载黑苹果星球整理好的文件包：

已有157887次阅读

最后，把以上你需要的 SSDT 文件放到 /EFI/OC/ACPI/ 目录，并在 config.plist 文件中启用：（下图使用的软件是 OpenCore Configurator，点击“浏览”添加指定文件）

更多 OpenCore 详解，请参阅：一步一步从零迁移到 OpenCore 中关于 SSDT 部分。

BIOS 设置

Intel 桌面端

Ivy Bridge（桌面端，第三代酷睿）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）
  - DVMT Pre-Allocated：32MB 及以上

Haswell 和 Broadwell（桌面端，第四、五代酷睿）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）
  - DVMT Pre-Allocated：64MB 及以上

Skylake（桌面端，第六代酷睿）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）
  - DVMT Pre-Allocated：64MB 及以上

Kabylake（桌面端，第七代酷睿）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）
  - DVMT Pre-Allocated：64MB 及以上

Coffeelake（桌面端第八、九代酷睿）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）
  - DVMT Pre-Allocated：64MB 及以上

Comet Lake（桌面端，第十代酷睿）

Comet Lake 平台建议安装 macOS 10.15.5 及以上
BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）
  - DVMT Pre-Allocated：64MB 及以上

Intel HEDT 平台

Haswell-E（第五代酷睿 X99 平台）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）

Broadwell-E（第六代酷睿 X99 平台）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）

Skylake-X/W 和 Cascade Lake-X/W（第七、九、十代酷睿X 和 Xeon）

BIOS 设置
- 关闭
  - Fast Boot
  - Secure Boot
  - VT-d（可以开启，前提是 DisableIoMapper 设置为 Yes）
  - CSM
  - Thunderbolt（全新安装时不当配置雷电接口可能造成问题，建议安装完成后再开启调试）
  - Intel SGX Intel Platform Trust
  - Intel Platform Trust
  - CFG Lock（MSR 0xE2 写保护）此项必须关闭，如果你的 BIOS 里没有此项，注意设置 AppleCpuPmCfgLock 和 Apple XcpmCfgLock 为 Yes。
- 开启
  - VT-x
  - Above 4G decoding
  - Hyper-Threading
  - Execute Disable Bit
  - EHCI/XHCI Hand-off
  - OS type：Other（如果你选择 Other 会导致 CSM 联动开启，选择 Windows 8.1/10 UEFI Mode）

AMD 平台

最终检查

请依次检查一遍所做的配置和文件，也可通过下面这个网站验证 config.plist 文件配置正确性。

https://opencore.slowgeek.com
一般情况下该网站支持 OpenCore 最新版本

镜像和替换 EFI 文件

镜像下载：目录 / 10.15 Catalina / 10.14 Mojave / 10.13 High Sierra / 10.12 Sierra / 10.11 El Capitan

安装教程：U盘版/恢复版安装教程 / 替换 EFI 文件

救命！我卡在跑代码啦！

如果你足够幸运，那么上面这些都做完以后，你就可以使用 U 盘开始 macOS 安装了。但对于卡在跑代码过程中的用户，黑苹果星球将搜集整理一些解决办法，列在这篇文章：OpenCore 安装卡住的拯救手册Q&A，欢迎反馈没有提到的问题。

安装完成后的完善

绝对新手：常见问题&名词解释&常用软件
完善教程：驱动英特尔核显 / USB定制教程 / 注入三码 / NVRAM / 休眠调试流程 / ssdtPRGen生成睿频数据 / 更多
开启 HiDPi：开启 HiDPi 解决字体模糊
配置工具：Clover Configurator.app / OpenCore Configurator.app
软件工具：Hackintool.app / PlistEdit Pro / ProperTree

0. 本站所有资源解压密码均为 heipg.cn
1. 本站资源收集于网络，仅做学习和交流使用，请于下载后24小时内删除。如果你喜欢我们推荐的软件，请购买正版支持作者。
2. 如有无法下载的链接，联系：admin#heipg.cn，或到QQ群进行反馈，我们将及时进行处理。
3. 本站发布的内容若侵犯到您的权益，请联系站长删除，联系方式：admin#heipg.cn，我们将第一时间配合处理！

黑苹果星球 » 一键生成黑苹果 OpenCore EFI 文件：OC.Gen-X

黑酱超级会员

100 评论

超级会员 N

2022年10月6日 at 下午8:22 登录以回复

感谢感谢,很棒的文章
超级会员 daifengzhong

2022年9月10日 at 下午1:39 登录以回复

进来学习一下。小白学习中。感谢
超级会员刘张男

2022年8月16日 at 上午10:04 登录以回复

没有Windows版
超级会员 kevin_5588

2022年7月27日 at 下午2:41 登录以回复

修改一下，显卡为：AMD rx6600
超级会员 kevin_5588

2022年7月27日 at 下午2:40 登录以回复

大神好，请教各位个问题，台式电脑配置如下：CPU:amd r5 3600,显卡：amd rx600 8G,主板：华擎a320M，安装的MAC版本为mac12.2.1,已按OC.Gen-X教程生成EFI文件，并能正常安装，使用的过程中发现的问题：在用爱奇艺客户端播放任何影视剧，在选择清晰度时最高为1080P，没有4K，本人爱奇艺为会员，但我的笔记本同样装的是黑果，爱奇艺客户端播放影视剧时，清晰度就有4K的，请问这是为什么啊？是哪里出了问题，请赐教，谢谢！
1. 超级会员黑酱
  
  2022年7月27日 at 下午4:31 登录以回复
  
  这个是典型的DRM问题，翻阅教程里DRM相关这篇
  https://heipg.cn/tutorial/hackintosh-drm-playback.html
  1. 超级会员 kevin_5588
    
    2022年7月27日 at 下午11:21 登录以回复
    
    您好，按照您推荐的教程试了，我提取并注入了，我的显卡是：AMD RX6600，独显，我注入的是：shikigva=128，但是爱奇艺客户端还是没有清晰度4K的，最高是1080P，请问这是什么问题，哪里有问题呢？谢谢您了。
    1. 超级会员黑酱
      
      2022年7月27日 at 下午11:59 登录以回复
      
      更换MacPro7,1
      尝试shikigva=256
      1. 超级会员 kevin_5588
        
        2022年7月28日 at 下午4:04
        
        大神您好，您说的更换MacPro7,1，尝试shikigva=256这种方法我还没试，想问您一下我这种情况在最初生成EFI文件时没有注入三码，和这个有关系吗？谢谢！
      2. 超级会员 kevin_5588
        
        2022年7月28日 at 下午8:27
        
        您好，我已注入hikigva=256，且在生成EFI时就是MacPro7,1，但是爱奇艺客户端还是没有清晰度是4K的选项，请问大神还会哪里出问题啊？谢谢！
      3. 超级会员黑酱
        
        2022年7月28日 at 下午10:20
        
        如果你现在可以正常播放Apple Music或者其他上述DRM测试通过就算正常
        爱奇艺我也没测过，明天有空测一下
      4. 超级会员 kevin_5588
        
        2022年8月1日 at 下午6:13
        
        您好，您这几天试了爱奇艺客户端了吗？有4K的清晰度吗？还是只有1080P的?
      5. 超级会员黑酱
        
        2022年8月2日 at 上午12:02
        
        看到你的消息试了，确实没有，可是白苹果打开也没有
        要不麻烦你说几个片名我再看下
      6. 超级会员 kevin_5588
        
        2022年8月2日 at 上午8:32
        
        您好大神，您看最新出的电影电视剧等都有4K的
      7. 超级会员黑酱
        
        2022年9月18日 at 上午12:31
        
        我的黑苹果有爱奇艺4k，但是白果本没有……
        好了，破案了，不要在App Store下载爱奇艺，到官网去下载
      8. 超级会员 kevin_5588
        
        2022年11月2日 at 下午4:27
        
        大神好，我就是从官网上下载的，但是还是没有4K。请问会是哪的问题啊。谢谢！
超级会员十念

2022年7月16日 at 上午2:46 登录以回复

11代支持吗
1. 超级会员黑酱
  
  2022年7月16日 at 下午4:23 登录以回复
  
  11代仿冒一下cpuid就好了，其它和10代一样
注册会员晴竹

2022年6月14日 at 下午4:37 登录以回复

66666666
超级会员旧

2022年6月10日 at 下午10:59 登录以回复

新版本貌似不支持12代
1. 超级会员黑酱
  
  2022年6月11日 at 上午12:22 登录以回复
  
  是的，这个软件停更了
超级会员杨进生

2022年5月18日 at 上午7:44 登录以回复

老师你好。下载需要密码。谢谢！
1. 超级会员黑酱
  
  2022年5月18日 at 上午8:07 登录以回复
  
  如果有解压密码的文件，密码全部是heipg.cn
  OC-Gen-X文件版本列表：https://heipg.cn/tag/oc-gen-x
超级会员朕

2022年5月13日 at 下午7:06 登录以回复

请问用u盘把系统装好后再设置免优盘启动一直失败，提示报错can\'t perform kext scan:no kext summary等等这种报错怎么办？
1. 超级会员黑酱
  
  2022年5月13日 at 下午10:29 登录以回复
  
  这种错误...你的efi应该进不去系统