题记：#

这大概是一种极其小众的需求吧，结果被幻梦遇上了。之前应该有提到过，幻梦的动态博客halo部署在一台nuc小主机上，总受周知nuc在这个时代成为软路由圣体之前其实是安装黑苹果的首选项，尤其是nuc5中的NUC5i5RYK。因为这台机器搭载了一个可能是除了苹果以外只有intel在自家主机上有使用过的5代i5处理器，5250u。现在动态博客不用了，小主机也就闲置下来了，于是在黑苹果生命的末期来体验一下，圆上幻梦一个折腾黑苹果的梦。

警告：#

只是部分一定要在被安装的主机上进行的工作会在ubuntu上完成，剩下非必要环节放在Windows上完成（例如：烧录到U盘）与MacOS完成（例如：usb映射），另外这篇笔记里还存在一些未解决的问题，仅供参考。如果你在安装环节遇到一些问题，且项目的issues里没有提供解决方案的话，请善用Ai工具来完成检索和解答。此外目前由于5250u的核显为hd6000，因此Mac OS15应该是5250u最后支持的一个版本，但是我们不选15而是选择12作为体验。

安装Hardware-Sniffer#

通常Hardware-Sniffer是OpCore-Simplify自带的一个模块，但是由于我们是linux环境所以得特意安装一个linux支持的。

1
# 新建一个目录然后克隆项目
2
git clone https://github.com/lzhoang2801/Hardware-Sniffer.git
3

4
# 进入目录运行HardwareSniffer.py
5
python3 HardwareSniffer.py

进入后，选H输出Report.json

回车返回，选A输出ACPI

现在Hardware-Sniffer文件夹下会有一个SysReport，SysReport下有一个Report.json和ACPI文件夹，把这两个复制到一回会克隆好的OpCore-Simplify文件夹里。

安装OpCore-Simplify#

1
# 新建一个目录然后克隆
2
git clone https://github.com/lzhoang2801/OpCore-Simplify.git
3

4
# 把刚刚复制的json和文件夹丢到项目里
5
# 运行OpCore-Simplify.py
6
python3 OpCore-Simplify.py

选择1，输入Report.json的路径。nuc5可能会出现以下报错

1
Validation report for: /home/yume/opcore/OpCore-Simplify/Report.json
2

3
Hardware report is not valid! Please check the errors and warnings below.
4

5
Errors (7):
6
    1. Root.Monitor.ICD2400.Connector Type: Value 'HDMI-A' does not match pattern '^(VGA|DVI|HDMI|LVDS|DP|eDP|Internal|Uninitialized)$'
7
    2. Root.Monitor.ICD2400: Missing required key 'Connector Type'
8
    3. Root.System Devices.PNP0C0B.ACPI Path: Value '\_TZ_.FAN3' does not match pattern '^[\\]?_SB(\.[A-Z0-9_]+)+$'
9
    4. Root.System Devices.PNP0C0B_#1.ACPI Path: Value '\_TZ_.FAN1' does not match pattern '^[\\]?_SB(\.[A-Z0-9_]+)+$'
10
    5. Root.System Devices.PNP0C0B_#2.ACPI Path: Value '\_TZ_.FAN4' does not match pattern '^[\\]?_SB(\.[A-Z0-9_]+)+$'
11
    6. Root.System Devices.PNP0C0B_#3.ACPI Path: Value '\_TZ_.FAN2' does not match pattern '^[\\]?_SB(\.[A-Z0-9_]+)+$'
12
    7. Root.System Devices.PNP0C0B_#4.ACPI Path: Value '\_TZ_.FAN0' does not match pattern '^[\\]?_SB(\.[A-Z0-9_]+)+$'
13

14
Warnings (4):
15
    1. Root.BIOS: Unknown key 'Above 4G Decoding'
16
    2. Root.GPU.Intel Corporation HD Graphics 6000: Unknown key 'Bus Type'
17
    3. Root.Sound.Realtek ALC283: Unknown key 'PCI Path'
18
    4. Root.Sound.Realtek ALC283: Unknown key 'ACPI Path'

1
# 安装acpica-tool
2
sudo apt install acpica-tools -y
3

4
# 导出ACPI log
5
sudo acpidump > acpi.log
6

7
#提取dat
8
acpixtract -a acpi.log
9

10
# 反编译dsdt
11
iasl -d dsdt.dat

1
If ((Arg0 == 0x03))
2
        {
3
            If ((Zero == ACTT))
4
            {
5
                If ((ECON == One))
6
                {
7
                    \_SB.PCI0.LPCB.H_EC.ECWT (Zero, RefOf (\_SB.PCI0.LPCB.H_EC.CFAN))
8
                }
9
            }
10
        }

下载MacOS12镜像#

先安装acidanthera/OpenCorePkg工具

还是在一个合适的位置克隆项目

1
# 克隆项目
2
git clone https://github.com/acidanthera/OpenCorePkg.git
3

4
# 进入工具目录
5
cd ./OpenCorePkg/Utilities/macrecovery
6

7
# 拉取15版本镜像
8
python3 macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000000000 download

把包含镜像的文件夹com.apple.recovery.boot、此前的EFI文件夹，保存到一台可以制作启动u盘的系统上。幻梦这边还是使用了另一台Windows来完成这两步的工作。

制作启动U盘#

下载一个Rufus来制作启动盘

https://github.com/pbatard/rufus/releases

千万要注意，此操作需要格式化u盘，请确保u盘里已经做好备份或内部无再需要的文件。

初始化u盘后将EFI、com.apple.recovery.boot文件夹、usb_blueprint.json拖入盘内。

启动U盘制作完成，安全弹出后插在准备安装U盘的主机上，进入bios选择u盘启动。

进入启动盘#

进入引导后选择第一个选项运行。此时会出现黑屏，这是正常情况，等一段时间会出现跑码，此时说明成功进入安装环节。

选择对应的语言

选择磁盘工具对硬盘进行操作

点进去先别急着操作，想清楚自己有几块硬盘；需要在哪一块硬盘上安装系统；需要抹除的硬盘是否还有重要资料未保存；是否真的需要抹除硬盘。

想清楚上面的内容再进行后面的操作

幻梦这边是单硬盘，空间也不够只能选择抹除掉原来的ubuntu来安装MacOS

抹除硬盘后选择正确的硬盘进行安装（Mac OS 12名称应该为Monterey，幻梦第一次就安装错了，这是最后检查的机会，不然一会只能重装了）

后面就等待进度条完成，过程中可能会反复重启几次。

最后进入设置界面完成设置。

生成UTBMap.kext文件#

现在我们应该顺利进入到MacOS系统了，可能还存在一些小问题或者卡顿的大问题，如果出现卡顿问题先跳转到下面疑难杂症里面尝试解决，为了保证阅读到流畅性还是先写如何导入。

这一步，取下刚刚带启动EFI的u盘，把u盘内的文件进行备份。备份完成后我们装一个Windows PE系统到U盘里，制作winPE是必须要做的，因为我们等会替换EFI还是要用winPE的。

（这步生成USB Map主要是力求完美的操作，之前自动化生产的EFI通常已经能驱动usb设备了，真不想做可以不做这一步）

制作PE盘，我们挑一个USB3.0的U盘。这个很重要，一定要是USB3.0的，不然之后这个USB端口在Mac下就只有2.0的速度了。

PE系统很多，请自行选择。幻梦选了老牌的微PE

做好PE后下载https://github.com/USBToolBox/tool/releases，下载windows.zip文件复制到PE里等会要用到。

刚刚备份的，尤其是EFI也复制进去。

然后，在准备一个USB3.0的设备，推荐是U盘，之后识别端口需要用到，u盘还能方便我们制作新的config.plist。

进入pe后解压zip并进入文件夹，双击Windows.exe启动工具，启动不了的可以试试在文件夹位置打开cmd然后./Windows.exe尝试打开

选择D. Discover Ports

掏出我们刚刚另外准备好的usb3.0设备，依次测试每个usb接口。注意：工具5秒进行一次识别，确认工具刷新，识别成功后，再试下一个

全部完成后，B退出。到第一页后选择S. Select Ports and Build Kext

确认识别到的USB口数量正确，选择K，进行生成。

生成完成在这个工具的目录下会多一个UTBMap.kext我们把这个复制到/EFI/OC/Kexts下，我们现在要想办法更新config.plist。第一种办法，把整个EFI文件夹复制到一个新的U盘里备用；第二种方法，关机拔出U盘进行下一步

把U盘插到一个Windows系统的主机上，我们需要使用到一个工具https://github.com/corpnewt/ProperTree

拉取以后运行ProperTree.bat

我们导入刚刚/EFI/OC下的config.plist

然后我们再选择OC snapshot

ctrl+s保存，保存完后退出取下U盘，我们在来到winPE完成后续操作。

导入EFI#

进入PE后我们使用自带的磁盘精灵工具，左侧找到一个名为ESP的卷，卷标为EFI，通常情况下这个卷里是空的我们选到文件预览，直接把我们刚刚完成修改后的整个EFI文件夹丢到里面。

由于我们是单系统，直接重新启动在bios中将硬盘设置为第一启动项完成我们的所有工作。

疑难杂症#

幻梦目前遇到的最严重的问题是与核显输出相关，暂时也无法完全解决。

1
csrutil disable

1
git clone https://github.com/xzhih/one-key-hidpi.git

1
csrutil enable

最后#

享受你的黑苹果吧，目前这个还不是完美黑苹果系统，不过至少能够正常使用了，这个笔记到这里也就结束啦。