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

主要参考资料

• 黑果小兵 - 资源下载，各种详细说明和资料
• 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 - 可选

问题和解决

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

2. 无法读取硬盘。原因，由于使用了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>
   

3. 睡眠唤醒后，界面卡顿。

   • TMx86 #3
   • 睡眠唤醒后，Terminal下输入 log show --last 5m | grep TSC，如果有 Unsynchronized TSC for CPU，则需要 VoodooTSCSync.kext

4. Clover 启动界面包含无效条目

   • 使用Cover Configurator编辑config.plist。GUI，Hide Volume，添加preboot, VM
   • GUI，Scan，勾选两次Legacy。强制生成禁用Legacy的项目，默认虽为禁用但不起作用。

5. Clover 启动界面无法显示原生分辨率

   • 主板支持显卡的UEFI启动，显卡firmware包含GOP。主板禁用CSM，开启原生分辨率
   • 主板不支持显卡的UEFI启动，需开启CSM。CsmVideoDxe.efi Clover引导时可修正分辨率，但进入mac后黑屏

6. BIOS下，没有启动mac的条目

   • EasyUEFI - Windows下修改UEFI启动项
   • Clover EFI shell / TMx86 #3 - 手动修改UEFI启动项