黑苹果安装 macOS 10.15 Catalina

2019-11-23 本文已影响0人莲子粥

每次安装黑苹果都要花很多时间重新查找资料，这次将要点记录下来

主要参考资料

黑果小兵 - 资源下载，各种详细说明和资料
Hackintosh vanilla desktop guide - 简洁的安装教程，明确的clover设置说明，带有关键资源的链接
Hackintosh.com - 整理好的安装教程
tonymacx86 - 黑苹果论坛，解决问题的地方

资源下载

安装镜像 / 黑果小兵 - 合集形式，EFI文件夹下内容杂糅，不适合特定的个体。可作为完善的备份资料，覆盖安装最新的Clover
Clover - 启动引导
Clover Configurator - 图形界面的Clover设置编辑器
Kexts - 自动编译保持最新的Kexts，或者对应kext的Github repo

最小化原则。只添加运行所必须的最少的 configs/drivers/kexts，避免对系统的多余的修改。遇到问题时针对性的解决。这在不清楚各个设置或代码包的作用和影响时，尤为重要。

通用安装教程

黑果小兵的安装教程 - 详细的中文安装过程
TMx86 Catalina guide & Vanilla guide - 英文安装教程，关键步骤的形式，比较简洁

针对性的调整

台式机配置

Intel E3-1230v2, Ivy bridge
AMD RX580 8G
Asrock B75 Pro3, AMI UEFI
- Onboard LAN Realtek RTL8111E
- Onboard audio Realtek ALC892
- 2 x SATA3 by ASMedia ASM1061
Monitor LG 34WK650, HDMI
Razor wired keyboard & wireless mouse
安装mac到独立的SSD

安装前的准备

下载必要的资源，安装镜像、Clover、Clover Configurator。kext可在安装后按需下载
制作安装U盘
- windows下用 Etcher 将安装镜像刻录到U盘
- U盘内容会完全抹去，U盘容量 > 16G。
安装Clover到U盘
- mac下用Clover Configurator加载U盘的EFI分区，将原有的EFI文件夹重命名为EFI_backup作为备份，安装Clover到U盘，默认配置，注意安装位置选择U盘而不是当前的mac
- 如果只有windows，需要在windows下加载U盘EFI分区进行修改，或者直接修改镜像的EFI分区
Clover的一些设置
- config.plist，启动参数中增加 agdpmod=pikera
- EFI drivers，对于Clover r4986之后的版本
  - 位置在 EFI -> CLOVER -> drivers -> UEFI，可删除旧版文件夹 EFI -> CLOVER -> drivers64UEFI，EFI -> CLOVER -> UEFIDrivers
  - Drivers文件名，已不需要 -64 的后缀
- 必备的drivers和kexts
  - ApfsDriverLoader.efi, AptioMemoryFix.efi, DataHubDxe.efi, FSInject.efi, HFSPlus.efi, VirtualSmc.efi 或 SMCHelper.efi
  - AppleALC.kext, Lilu.kext, RealtekRTL8111.kext(或网卡对应驱动), USBInjectAll.kext, WhateverGreen.kext, VirtualSMC.kext 或 FakeSMC.kext
    EFI Drivers Kexts

英文教程中都默认已有一台mac，只有这样才能合法的获取mac安装文件，所以很多安装步骤会利用现有mac。当然，已有一台mac是最方便的

安装

BIOS配置
- vt-d, secure boot, AHCI等
开机启动选项，选择 USB EFI
- 如果U盘含有Clover和WinPE两个启动引导，名称会相同，试一下即可
Clover界面，Boot macOS Install from Install macOS Catalina
- 硬盘分区，使用APFS
- 如果无法分区，见之后的可能的解决方法 [2]。
正常安装 mac
- 安装过程中重启后，选择从硬盘启动，如 Boot macOS Install form [卷宗名称]，这里的[卷宗名称]是在分区时命名的。完成安装

安装后的配置

将U盘中的EFI文件夹考入硬盘的EFI分区内
- mac安装时生成的EFI/Apple文件夹可删除
Hackintosh vanilla desktop guide，对照此教程内的cpu版本，梳理Clover的 config.plist
使用最新版本的kext - 或从镜像备份中获取
其他EFI Drivers - Clover Configurator中可下载，镜像备份中也有，或者通过完整安装Clover（安装前备份EFI文件夹）
CPU电源管理 - 可选，多数经Clover配置已可用

修正USB接口限制或 Catalina USB fix

com.apple.iokit.IOUSBHostFamily    83FB0F0F 83FB3F0F
com.apple.driver.usb.AppleUSBXHCI  83F90F0F 83F93F0F

安装Kexts到/L/E - 可选

问题和解决

Clover界面点击启动条目后黑屏，可尝试增加启动参数 agdpmod=pikera

无法读取硬盘。原因，由于使用了SATA扩展芯片，缺少驱动。例如，引导log提示 Disk I/O error，DiskUtil分区失败提示 unable to write to last block等。
以下是适用于mac 10.15.x的修正，AppleAHCIPort 40600200 -> 00000000

Clover Configurator

<!-- 添加到 KernelAndKextPatches / KextsToPatch 下 -->      
        <dict>
            <key>Comment</key>
            <string>ALPM IO Error AppleAHCIPort</string>
            <key>Disabled</key>
            <false/>
            <key>Find</key>
            <data>
            QGACAA==
            </data>
            <key>InfoPlistPatch</key>
            <false/>
            <key>MatchOS</key>
            <string>10.15.x</string>
            <key>Name</key>
            <string>AppleAHCIPort</string>
            <key>Replace</key>
            <data>
            AAAAAA==
            </data>
        </dict>

睡眠唤醒后，界面卡顿。
- TMx86 #3
- 睡眠唤醒后，Terminal下输入 log show --last 5m | grep TSC，如果有 Unsynchronized TSC for CPU，则需要 VoodooTSCSync.kext
Clover 启动界面包含无效条目
- 使用Cover Configurator编辑config.plist。GUI，Hide Volume，添加preboot, VM
- GUI，Scan，勾选两次Legacy。强制生成禁用Legacy的项目，默认虽为禁用但不起作用。
Clover 启动界面无法显示原生分辨率
- 主板支持显卡的UEFI启动，显卡firmware包含GOP。主板禁用CSM，开启原生分辨率
- 主板不支持显卡的UEFI启动，需开启CSM。CsmVideoDxe.efi Clover引导时可修正分辨率，但进入mac后黑屏
BIOS下，没有启动mac的条目
- EasyUEFI - Windows下修改UEFI启动项
- Clover EFI shell / TMx86 #3 - 手动修改UEFI启动项