OpenCore 简易教程 以及 案例分享

RMTTT

注意：此教程已不再更新，更新地址改为：https://rmtt.gitbook.io/opencore-vanilla-guide/

OpenCore的大部分配置跟CLOVER实际上是差不多的，所以如果你熟悉CLOVER的话，再来配置OC应该是一件比较简单的事

OpenCore官方仓库：https://github.com/acidanthera/OpenCorePkg (请从这里下载OC的最新版，如果不知道Github怎么使用，建议先百度学习一下，放心，很简单)

下载最新的release后，里面会有一个Configuration.pdf，这里面包含了OC各项功能的详细说明，当然，如果你觉得难懂，而且英语还可以的话，可以看看 https://khronokernel-2.gitbook.io/opencore-vanilla-desktop-guide，当然，你也看这篇帖子接下来的内容。
PS: 不管是OC或是其他驱动，请尽量去官方仓库下载最新的稳定版，由于帖子里放太多超链接会发不出来，所以驱动下载地址都放到群公告里了
OC交流QQ群: 786201418

以下开始正文：
1. plist简单介绍
因为OpenCore Configurator的更新进度还没有跟上OC的更新进度，所以有必要使用文本编辑器来编辑OC的config.plist，这里推荐使用XCode或者vs code。
首先介绍一下plist中的一些名词（如果觉得难懂可以跳过）：

• plist：plist是XML的一个子集，更标准一点的名字应该叫：com.apple.property-list。plist由很多plist对象组成，这些对象一起组成了一个树形的结构。可以使用plutil来检查plist格式是否正确，具体用法：打开终端，进入你的plist文件所在目录，输入
  1. plutil -lint <filename>

  复制代码
  如果格式正确会输出OK，如图                                                                          更多关于plist的信息可以参考：https://www.apple.com/DTDs/PropertyList-1.0.dtd (语法)，或者在终端里面输入 man plutil
• plist节点的数据类型：集合类型：plist array, plist dictionary, plist key    值类型：plist string,plist data, plist date, plist boolean, plist integer, plist real
• plist对象(object)：plist数据类型的具体实例，也可以把它当作一个普通的值（比如数字1，字符串"abcd"等等）
• plist数组(array)：plist数组可以包含0个或者多个plist对象，在plist中用<array></array>表示
• plist字典(dictionary)：plist字典是一个key-value映射，可以包含0个或多个plist键值，在plist中用<dict> </dict>
• plist键值(key)：由ascii码组成的字符串，在plist中用<key> </key>表示
• plist字符串(string)：由ascii码组成的字符串，在plist中用<string> </string>表示
• plist data：经过base64编码的数据，在plist中用<data></data>表示
• plist布尔值(boolean)：表示真假，真用<true/>表示，假用<false/>表示
• plist整数(Integer)：普通的整数，在plist中用<integer></integer>表示
  

还有一些其他的类型，但是在OC的config中用不到，就不做介绍了，具体实例可以参考OC的Sample.plist。
2. 配置
OC下载解压后的EFI目录应该是这样的

下面开始来一个一个完善，不过首先需要把OC/Docs下面的SampleFull.plist复制到EFI/OC下，然后改名为config.plist
2.1 Drivers
CLOVER使用的driver在OC中不一定兼容，要注意一下（完整的列表参考OC的Configuration.pdf 11.2）。对于大部分电脑，有如下3个driver应该就能启动了。

• ApfsDriverLoader.efi   识别APFS分区
• VBoxHfs.efi  识别HFS分区
• FwRuntimeServices.efi  用来替换AptioMemoryFix.efi
  

但如果想要更好的使用OC，最好还需要加上如下两个driver：

• UsbKbDxe.efi   当OC的内置驱动不工作时，加上这个efi可以提供Apple热键和FileVault的支持。
• VirtualSMC.efi  配合VirtualSMC.kext使用，不能和FakeSMC.kext同时使用。
  

和Clover不同的是，仅仅把driver放到Drivers目录下并不会让OC加载这些driver，还需要在config.plist中指定这些driver。首先打开config.plist，这里使用的是XCode

你打开的时候应该在最上面会有两行以 # 开头的注释，这个可以删可以不删，没有影响。
然后点开UEFI -> Drivers，我们需要在这个节点（也就是上面提到的plist对象，一个节点便可以当成一个对象）下面指定需要加载的driver。第一次打开的时候可以看到已经写好了几项，这时你可以直接修改那些项的Value，当你把鼠标移动到那一行上面时，会有一个加号和减号，点击加号可以在同级节点上添加一行，点击减号可以删掉这一行。因为我自己使用了Fusion Driver，所以需要把ApfsDriverLoder.efi换成apfs.efi，添加完成后如下图

注意，这里的每一行的数据类型都是string，Value就是OC/Drivers目录下的文件名。
2.2 Kexts
和Clover一样，这下面放的是启动macOS所必须的内核扩展驱动
首先介绍几个必要的驱动：

• VirtualSMC  模拟SMC，在OC下推荐使用VirtualSMC而不是FakeSMC
• Lilu  非常重要的一个kext，拥有很多强大的插件
• WhateverGreen   用于驱动显卡以及自动完成显卡相关的patch
• AppleALC   用于驱动AppleHDA
• RealtekRTL8111  用于驱动Intel网卡
• AppleMCEReporterDisabler  如果使用MacPro6,1 / MacPro7,1 /iMacPro 7,1 这几个SMBIOS，可能需要这个驱动来解决一些启动时的错误
• 完整的kext列表
  

和前面的Drivers一样，将驱动放入Kexts目录下后，还需要在config.plist中指定后才能加载。
同样的先用XCode打开config.plist，然后点开Kernel -> Add，这里便是指定加载驱动的地方，第一次点开的时候里面应该有了一些驱动，如果这些驱动你也需要的话，可以不需要修改。随便点开一个item，可以看见如下的结构

先解释一下其中的每一项：

• BundlePath：驱动的相对路径，如果是放在OC/Kexts下的话，直接填驱动的完整文件名即可
• Comment：备注，可写可不写
• Enabled：是否使用该驱动，XCode里面可以直接选择YES或者NO，如果是用文本编辑器可以填<true/>或者<false/>
• ExecutablePath：驱动中可执行文件的路径，一般都在驱动的Contents/MacOS目录下，填相对路径即可
• MaxKernel： 指定最高的内核版本，如果macOS的内核版本高于这个值便不会加载
• MinKernel：  指定最低的内核版本，如果macOS的内核版本低于这个值便不会加载
• PlistPath：指定驱动的plist文件路径，相对路径，一般就在驱动的Contents目录下
  

注意，每一行的数据类型必须要对应，不能随意！
我自己的添加完后如下图：


PS：比如VoodooPS2Controller.kext这种包含插件的，插件也要单独指定，如下图


2.3 ACPI
OC同样也可以自己指定DSDT或者SSDT的补丁，将aml文件放入OC/ACPI目录下，然后打开config.plist，找到ACPI -> Add，第一次打开如下图：

每一个item便是一个aml文件，其中每一项的意义如下：

• Comment：备注，比如电池的hotpatch，你可以用battery备注一下
• Enabled：是否使用这个patch或者说aml文件
• Path：aml文件的目录，将aml文件放入ACPI目录后填相对目录即可，也就是aml的完整文件名
  

我自己使用的patch如下图，不同的电脑有patch，请使用适合的patch


当然，OC也提供了ACPI的改名功能。首先找到ACPI -> Patch，默认应该是这样的：

如果你不需要默认的这两个patch，可以直接删掉，或者改动其中的某些字段，先来介绍一下其中的每一项：

• Comment：备注
• Count：该patch被应用的次数，0表示不限制
• Enabled：是否使用该patch，类型是boolean
• Find：需要查找的值，类型是data，在XCode中可以直接输入"<十六进制>"即可，比如要查找5f513131，可以直接输入<5f513131>
• Replace：查找后需要替换的值，类型同Find
• 其他类型一般默认即可
  

这一功能跟Clover是一样的，如果你已经有了clover的配置，可以直接复制，推荐使用Clover Configurator，其中的Acpi -> Patches便是你需要的

对于macOS 10.15，需要将ACPI中的主EC名改为EC，下图是我自己的一些patch


这些都做完后，便可以开始尝试启动了

3. NVRAM
NVRAM是OC中很重要的一个部分，用于保存系统的一些有用信息，下次开机时可以直接使用，比如音量、亮度等等，对于非Z370 300系列的主板，可能都需要模拟NVRAM。

OC使用nvram.plist来保存nvram的字段，首先来生成nvram.plist。
使用XCode打开config.plist：

• Booter -> Quirks -> DisableVariableWrite : YES
• NVRAM -> LegacyEnable : YES
• Misc -> Security -> ExposeSensitiveData : 3
• NVRAM -> LegacySchema : NVRAM变量集，生成nvram.plist后，可以将生成的变量添加进来，如果有同名的则不需要
  

同时，FwRuntimeServices.efi也是必须的
打开下载的opencore目录，将其中的Utilities/LogoutHook复制到/Users/<你的用户名>，比如 /Users/abc，然后打开终端，执行：

1. sudo defaults write com.apple.loginwindow LogoutHook /Users/你的用户名/LogoutHook/LogoutHook.command

复制代码

4. DeviceProperties

这一部分和Clover的Devices -> Properties 一样，如果你之前已经配置好了CLOVER，可以用XCode打开CLOVER的config.plist，

然后将上图中红色的部分直接复制到OC config.plist的DevicesProperites下。
如果没有配置过CLOVER，可以参考Whatevergreen的启动参数，系统启动成功后再用Hackintool可以很方便的完成显卡和声卡的配置。

5. 启动参数
OC的启动参数在config.plist的Root -> NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82中，刚开始的时候加个-v和-keepsyms=1应该就行了，其他已经的启动参数如下：

• acpi_layer=0xFFFFFFFF
• acpi_level=0xFFFF5F
• batman=value
• batman-nosmc=1
• cpus=VALUE
• debug=VALUE   如果出现panic时不想让电脑重启，可以添加debug=0x100
• io=VALUE
• keepsyms=1 (显示panic log)
• nv_disable=1 (禁用N卡)
• nvda_drv=1
• npci=0x2000
• lapic_dont_panic=1
• slide=VALUE
• smcdebug=VALUE
• -s   单用户模式
• -v    啰嗦模式
• -x    安全模式
• no_compat_check
• nehalem_error_disable
  

到这里就可以开始尝试启动了
6. SMBIOS
OC设置SMBIOS比较繁琐，首先打开config.plist，然后找到Root -> PlatformInfo
打开Clover Configurator，或者其他能找到macbook详细的SMBIOS的工具或者网站，然后把对应的信息填入OC config.plist的PlatformInfo中，因为字段比较多，所以比较繁琐，自己找到config.plist中对应的字段填上去就行。

其中的MLB和ROM可以在Clover Configurator -> Rt Variables中生成。

7. 去除调试信息

• NVRAM -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> boot-args: 去掉-v
• UEFI -> Protocols: ConsoleControl设置为Yes或者True或者OCC中打勾
• UEFI -> Quirks: ProvideConsoleGop、IgnoreTextInGraphics、SanitiseClearScreen均设置为Yes
• Misc -> Boot: ConsoleBehaviourOs设置为Graphics、ConsoleBehaviourUi设置为Text
  

8. 常见问题以及注意事项
如果你遇到了这里没有提及的问题以及解决方案，可以回帖说明，以供其他朋友参考

• 如果启动后发现USB全挂了（驱动都放好的前提下），可以尝试：UEFI -> Quirks -> ReleaseUsbOwnership : YES
• OC的ACPI改名不能作用与自己的hotpatch，制作hotpatch时要注意一下
• 如果启动OC时出现"failed to parse xx field of type x"，说明配置文件中的字段使用了OC不能识别的类型，比如“failed to parse real field of type 1”，说明config中有real这个字段的值，在文本编辑器中搜索real，可以看到<real>xx</real>，将其改为<integer>xx</integer>即可
  

9.Debug这部分的设置都在Misc->Debug中

9.1 保存Log到文件
将Misc->Debug->Target到第6位设置为0即可，下面给出一个示例：

• Target的第0位决定是否打印log，所以想要看到log这一位必须设置为，即现在的Target为：0000 0001
• Target的第6为决定是否将log输出到文件，将这一位设置为1即可，现在的Target为：0100 0001
  

0100 0001转换为10进制：65，所以在Target中填入65即可
之后的每次启动，OC都会在你的ESP目录生成一个日志文件，如图：



其他完善的项目以后再慢慢添加，或者你可以去找其他资料参考，也可以回帖提供你的方案

gongyuchang

x小白路过感谢楼主分享

RMTTT

nomcoych 发表于 2019-10-14 13:40
这教程真简易。

写的时候碰到触摸板误操了，直接发出来了

云中陌上

先关注后学习

loveqp

你的好东西。

Kira吟梦

太强了%%%%%MT

yuzhenghuan

你真&#128002;&#127866;老哥，也许你就是床说中的黑果天才吧哈哈

RMTTT

Kira吟梦 发表于 2019-10-14 17:51
太强了%%%%%MT

woc  这都被你发现了

oob

请告诉我 还需多久 才可以避免你的 误操作

summerain

坐等！谢谢

penghubingzhou

继续写，有需要的我可以给你重新编辑到1楼

RMTTT

penghubingzhou 发表于 2019-10-14 19:02
继续写，有需要的我可以给你重新编辑到1楼

完整的发不出来，说有垃圾信息。。。

LuobotouRobert

RMTTT 发表于 2019-10-14 19:47
完整的发不出来，说有垃圾信息。。。

应该是有敏感词吧。

RMTTT

内容已全部合并到1楼

RMTTT

penghubingzhou 发表于 2019-10-14 19:02
继续写，有需要的我可以给你重新编辑到1楼

麻烦合并到1楼

loveqp

这一篇是OC官方推荐的。https://bbs.pcbeta.com/viewthread-1815623-1-1.html

xhlgood0525

写的真棒，非常详细，受益匪浅。

xtwz

写的真棒，非常详细，受益匪浅。

penghubingzhou

RMTTT 发表于 2019-10-14 19:47
完整的发不出来，说有垃圾信息。。。

可以私聊我，把内容给我，我负责给你补图