# 欢迎 ## 概览 这个项目旨在让你的搭载了第 8 代、第 9 代 Intel CPU 、采用了清华同方模具的神舟笔记本，能够尽可能完美地安装上最新版本的 macOS 操作系统（俗称“黑苹果”）。 ## 如何使用 hasee-tongfang-macos 仓库下的配置文件？ #### 还没装好系统？ * 请按照 [安装教学视频](https://www.bilibili.com/video/av81263778) 里的指引安装好系统，并替换配置文件即可。 * 替换配置文件后，请按照[此视频](https://www.bilibili.com/video/av81263778/?p=2)指导，使用 Clover Configurator 或更新脚本生成新的 SMBIOS 序列号、UUID，并**执行以下优化脚本修复睡眠**： ``` sudo sh -c "$(curl -fsSL https://aya-buildbot.kirainmoe.com/optimizer)" ``` #### macOS 下安装/更新最新配置文件 使用更新脚本可以安装/更新最新配置文件。安装完系统后，在 macOS 的终端执行以下命令： ``` curl -fsSL https://aya-buildbot.kirainmoe.com/installer > inst && chmod +x ./inst && sudo ./inst ``` #### 手动下载和替换 你可以到 [Aya Buildbot](https://aya-buildbot.kirainmoe.com/) 下载对应机型的最新版本配置文件，然后按照[《EFI 替换教程》](https://hackintosh.kirainmoe.com/an-zhuang-zhong/efi-ti-huan-jiao-cheng) 替换。 #### 若想要使用 OpenCore 引导 可以前往对应机型带有 `-opencore` 后缀的分支，在 GitHub 页面点击 "Clone or Download" => "Download Zip" 下载最新版本。 ## 导航 请善于使用右上角的搜索框，搜索问题的关键字。 * [安装过程中的疑难解答](https://hackintosh.kirainmoe.com/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da) * [安装后的常见问题解答](https://hackintosh.kirainmoe.com/an-zhuang-hou/an-zhuang-hou-de-chang-jian-wen-ti-jie-da) * [硬件更换指南和兼容性报告](https://hackintosh.kirainmoe.com/an-zhuang-hou/ying-jian-geng-huan-zhi-nan-he-jian-rong-xing-bao-gao) * [常用命令和优化](https://hackintosh.kirainmoe.com/an-zhuang-hou/chang-yong-ming-ling-he-you-hua) * [Project: STAR BEAT! - 神舟同方机型键盘灯控制](https://github.com/kirainmoe/project-starbeat/releases) ## 兼容性情况 #### 兼容的型号 | 模具代号 | 型号 | 分支 | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

GK5CN5X
GK5CN6X

|

Z7-KP7GZ
Z7M-KP7GZ
Z7M-KP5GZ
Z7-KP7Z
Z7M-KP7Z
Z7M-KP5Z
Shinelon Yao 7000 (炫龙 耀7000)
Mechrevo Z2 Air (机械革命 Z2 Air)

|

gk5cn6/5x-clover (Clover)
gk5cn6/5x-opencore (OpenCore)

| | GJ5CN64 |

Z7-KP7EC
Z7-KP7GC
Z7-KP7GA
Z7-KP7GE
Z7-KP7GH

|

gj5cn64-clover (Clover)
gj5cn64-opencore (OpenCore)

| | GI5CN54 |

Z7M-KP7GC
Z7M-KP5GC
Z7M-KP7GA
Z7M-KP5GA
Z7M-KP7GE
Z7M-KP5GE
Z7M-KP7GH
Z7M-KP5GH

|

gi5cn54-clover (Clover)
gi5cn54-opencore (OpenCore)

| | GK7CP6R |

Z7-CT7GK
Z7-CT7VH
G7-CT7VK
Z7-CT7VA

|

gk7cp6r-clover (Clover)
gk7cp6r-opencore (OpenCore)

| | GK5CP6X |

Z7M-CT7GS
Z7M-CT5GA
Mechrevo Z2 Air-G (机械革命 Z2 Air-G)

|

gk5cp6x-clover (Clover)
gk5cp6x-opencore (OpenCore)

| #### 不兼容的型号 请注意，本仓库只适配使用**因特尔第 8 代和第 9 代**标压酷睿处理器、使用**清华同方模具**的笔记本，故以下机型**不能**正常使用此配置文件，包括但不限于以下机型： | 型号 | 原因 | | ----------------------------------------------------------------------------------- | -------------- | |

Z7(m)-KP7/5GT
Z7(m)-KP7D2
Z7(m)-KP7/5GS

| 使用同方七代以下模具 | |

Z7(m)-CT7/5N\*
Z7-C7TPro
Z7(m)-KP7/5S\*
Z7(m)-KP7/5D1
Z7(m)-SL\*

| 使用蓝天笔记本模具 | |

ZX7\*
GX7\*

| 使用蓝天桌面模具 | |

K6*0*-\*\*\**
Z7-i7*

| 使用蓝天模具或为四代以下平台 | |

精盾 U45S1
精盾 U47T1
...

| 使用广达模具 | 对于上述机型，可以到百度、远景或[此仓库](https://github.com/daliansky/hackintosh)尝试找到对应模具/机型的 EFI. #### 兼容的 macOS 版本 **注意：因为维护者不再测试旧版系统，故未来的配置文件可能随时停止对 macOS 10.14 (Mojave) 和 macOS 10.13 (High Sierra) 版本系统的支持。** 当前版本配置文件的系统支持表如下： | 版本号 | 版本代号 | 是否理论兼容 | 维护者实机测试正常 | 用户实机测试正常 | | ------------------ | ----------------- | ------------- | --------- | -------- | | 10.13.6 | 17G65 | ❌ no | - | - | | 10.13.6 \~ 10.14.5 | 17G2112 \~ 18F132 | 🔒 deprecated | ❓untest | ❓untest | | 10.14.6 | 18G87 | ✅ yes | ✅ yes | ✅ yes | | 10.15 | 19A603 | ✅ yes | ✅ yes | ✅ yes | | 10.15.1 | 19B88 | ✅ yes | ✅ yes | ✅ yes | | 10.15.2 | 19C57 | ✅ yes | ✅ yes | ✅ yes | | 10.15.3 | 19D76 | ✅ yes | ✅ yes | ✅ yes | > ✅ yes：当前版本的配置文件在该系统版本下测试通过，各种功能符合预期\ > 🔒 deprecated: 配置文件曾经兼容此版本系统，但现阶段无人测试；且未来可能不再兼容该版本\ > ❓untest：没有用户或开发者在此设备上测试\ > ❌no：配置文件不兼容此版本 ## 设备驱动情况 以下为维护者个人电脑的配置详情，以及对比原机的配置。 | Component | Model | Comment | | --------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------- | | CPU | Intel Core(TM) i7-8750H | 除 GJ5CN64 / GI5CN54 之外，其它模具的 i5 版本与 i7 版本的型号可兼容同一套配置文件 | | GPU | Intel UHD630 / Nvidia GTX1060 | Nvidia 独显无法驱动，原因详见[这里](/an-zhuang-hou/an-zhuang-hou-de-chang-jian-wen-ti-jie-da#na-wei-shen-me-du-xian-wu-fa-qu-dong) | | RAM | Micron Crucial 8GB+8GB | | | NVMe | WD Black SN750 NVME SSD 500G | 请不要购买三星 PM981/970EvoPlus 等 macOS 不支持的硬盘 | | SATA SSD | Phison SATA SSD 128G | | | Wireless | BCM94360CS2 | 原机自带的 Intel AC9462/AC9560 无法在 macOS 下驱动 | | Ethernet | Realtek RTL8168H | | | Audio | Realtek ALC269vc | | #### 正常工作的功能 * CPU 睿频、变频 * 核芯显卡 Intel UHD Graphics 630 * 亮度调节 * 触摸板 (I2C, PS/2) \[1] * 有线网卡 * 声卡 (扬声器、耳机、麦克风) \[2] * 原生电源管理、电池状态 * USB 3.0, Type-C * Intel 蓝牙 \[3] * 睡眠 \[4] * Fn 快捷键 \[5] * 摄像头 > 注： > > \[1] GJ5CN64 / GI5CN54 系列模具的 PS2 触摸板不支持 macOS 原生手势; I2C HID 触摸板可完美使用。\ > \[2] 声卡使用 AppleALC 仿冒内建，通过设备属性的方式，注入 `layout-id` 为 29.\ > \[3] 因特尔 AC9462/AC9560/AX200 无线网卡的蓝牙无需热启动即可加载固件。\ > \[4] 睡眠需要在安装系统后人为执行优化脚本调节参数，执行方式参见上文。\ > \[5] Fn 快捷键需要优化脚本安装守护程序支持，执行方式参见上文。 #### 无法使用 * 独立显卡（目前已知没有任何解决方案） > 已使用 `SSDT-DDGPU.aml` 屏蔽了独显 > > 由于同方八代以上模具的 HDMI / miniDP 直接由无法驱动的独显输出，所以 HDMI / miniDP 也无法使用。 * 无线网卡（Intel AC9462 无解） > 无线网卡无法使用的替代方案： > > * 蓝牙共享网络 > * USB共享网络 (HoRNDIS) > * USB网卡 > * 更换无线网卡\[推荐更换“BCM94360CS2 + 转接卡”方案] > > 由于 “**隔空投送 AirDrop**” 和 “**接力 Handoff**” 依赖于无线网络和蓝牙，所以此两项功能不可用。 * 读卡器（读卡器为 USB 2.0 外置通道，没有兼容驱动） ## 获取社区帮助 **请确保你在群里问问题之前，已经看过了教学视频、并使用了搜索功能查找并仔细阅读了项目文档内的相关内容！** | 群名称 | 神舟战神黑苹果 1 群 | 神舟战神黑苹果 2 群 | | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 群号 | 833022235 | 815359928 | | 加群二维码 | [![](https://camo.githubusercontent.com/48387899a2fe8c25754047f12bb691746f6e8759/68747470733a2f2f692e6c6f6c692e6e65742f323032302f30312f30352f734b68383735554331344c46656a762e706e67)](https://camo.githubusercontent.com/48387899a2fe8c25754047f12bb691746f6e8759/68747470733a2f2f692e6c6f6c692e6e65742f323032302f30312f30352f734b68383735554331344c46656a762e706e67) | [![](https://camo.githubusercontent.com/e209680e635b0a156fef1a5f808ad0d181bbdba8/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31312f32332f467a6b6570726e39504137626636712e706e67)](https://camo.githubusercontent.com/e209680e635b0a156fef1a5f808ad0d181bbdba8/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31312f32332f467a6b6570726e39504137626636712e706e67) | | 加群链接 | | | | 规模 | 1000 人群 | 500 人群 | | 特殊限制 | 因人数爆满，暂需付费 1 元入群 | **仅限清华同方模具的 8/9 代机型用户加入** | | 备注 | - | 新群人数较少，推荐新用户加入 2 群 | #### 我们要求你具有基本的知识，如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS，但多数情况我们只能帮你点睛。如果没有上述基技能，建议先前往远景论坛或国外黑苹果论坛爬帖。 ## 许可协议 & 捐赠 在 [Maruyama License 协议](https://github.com/kirainmoe/hasee-tongfang-macos/blob/master/LICENSE) 的许可下，使用本仓库下的所有配置文件都是免费的。如果有人向你售卖配置文件，请立刻要求他退款。 希望你们也能够发扬开源和分享精神，积极提出建议和想法、Pull Request，由大家共同打造完美的黑果体验。 当然，如果您认可我的工作，也可以通过捐赠支持我。所有的捐赠将会成为我更新的动力。 | 支付宝 | 微信 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![](https://camo.githubusercontent.com/9406f340557bc249c14cec86b77b24e84177cbc1/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f6a38646f6149565957744d586c4e4a2e706e67)](https://camo.githubusercontent.com/9406f340557bc249c14cec86b77b24e84177cbc1/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f6a38646f6149565957744d586c4e4a2e706e67) | [![](https://camo.githubusercontent.com/85198c8baaad14ea4438bf39621006b7fea10832/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f786b6f484973755a4c76747a4453502e706e67)](https://camo.githubusercontent.com/85198c8baaad14ea4438bf39621006b7fea10832/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f786b6f484973755a4c76747a4453502e706e67) | # 安装前须知 ## 配置文件的兼容性 对于系统版本而言，截止本页面编辑为止，配置文件兼容 macOS Mojave 全部版本和 macOS Catalina 所有已发布的 Beta 版本以及正式版，并且支持全新安装和系统内 OTA 更新。 理论上，在新版本的 macOS 系统发布后，我会在 1～2 天内更新配置文件，使其兼容最新版系统。因此在你每次系统内 OTA 之前，请先全量更新配置文件。 对于机型而言，理论上兼容所有神舟战神 8 代 / 9 代同方模具系列机型（例：Z7(m)-KP7/5(G)Z, Z7(m)-KP7/5GC, Z7(m)-KP7/5EC, Z7(m)-CT7/5GK(GS)/G7-CT7VK 等）。下面是详细的兼容性表格： | 模具代号 | 机型 | 分支 | | ------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------- | |

GK5CN5X
GK5CN6X

|

Z7-KP7GZ
Z7m-KP7GZ
Z7m-KP5GZ
Z7-KP7Z
Z7m-KP7Z
Z7m-KP5Z

| [master](https://github.com/kirainmoe/hasee-tongfang-macos) | |

GI5CN54
GJ5CN64

|

Z7-KP7EC
Z7m-KP7EC
Z7m-KP5EC

| [kp7ec](https://github.com/kirainmoe/hasee-tongfang-macos/tree/kp7ec) | |

GI5CN54
GJ5CN64

|

Z7-KP7GC
Z7m-KP7GC
Z7m-KP5GC

| [kp7gc](https://github.com/kirainmoe/hasee-tongfang-macos/tree/kp7gc) | | GK7CP6R |

Z7-CT7GK
Z7m-CT7GS
Z7-CT7VH
G7-CT7VK

| [ct7gk](https://github.com/kirainmoe/hasee-tongfang-macos/tree/ct7gk) | 该配置文件可能兼容其它未测试的 8 代以上同方模具神舟战神笔记本。 因为本人只拥有 Z7-KP7GZ，其他型号通过群内的朋友测试通过。后续所有的功能更新，会先在 KP7GZ 系列机型上测试稳定后才会下放。 注意，蓝天模具的神舟 Z7-KP7SC, Z7-KP7S1、同方模具的七代平台机型 Z7-KP7GT, Z7-KP7D2 等不属于该系列，并不保证能完全兼容，这些机型也不是本仓库配置文件的目标机型，因此针对此类设备的兼容性问题，请您自行解决。 ## 设备驱动情况 以下为维护者个人电脑的配置详情，以及对比原机的配置。 | Component | Model | Others | | --------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CPU | Intel Core(TM) i7-8750H (KP5(G)Z 为 i5-8300H) | | | GPU | Intel UHD630 / Nvidia GTX1060 | Nvidia 独显无法驱动，原因详见[这里](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E5%90%8E%E7%9A%84%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94#%E9%82%A3%E4%B8%BA%E4%BB%80%E4%B9%88%E7%8B%AC%E6%98%BE%E6%97%A0%E6%B3%95%E9%A9%B1%E5%8A%A8) | | RAM | Micron Crucial 8GB+8GB | | | NVMe | WD Black SN750 NVME SSD 500G | 请不要购买三星 PM981/970EvoPlus 等硬盘 | | SATA SSD | Phison SATA SSD 128G | | | Wireless | BCM94360CS2 | 原机自带的 Intel AC9462/AC9560 无法在 macOS 下驱动 | | Ethernet | Realtek RTL8168H | | | Audio | Realtek ALC269vc | | ### What's working * 睿频、变频正常（使用 18 款 MacBook Pro SMBIOS，最低 800Mhz, 最高睿频 4.1GHz） * Intel UHD630（已应用显存补丁，2048 MB） * 亮度调节（可在设置中调节或使用 Fn+F11, Fn+F12 快捷键，后者在九代同方机型上不可用） * I2C HID 触控板 * 有线网卡 * 声音（ALC269vc, 使用 AppleALC 仿冒，注入 layout-id 为 29 或 88，外放、耳机、麦克风全部正常） * 电池状态（现已使用 Clover Hotpatch 驱动） * USB （使用 USBInjectAll + SSDT 驱动，3.0 5G/s 速度正常，Type-C 可用） * 睡眠（使用 Clover Hotpatch 修复） * 摄像头 * etc. {% hint style="info" %} Tips：以上情况基于 KP7GZ 系列机型；对于使用其它机型的用户，可能会有一些功能不正常，请用户测试后反馈。 {% endhint %} ### What's partially working * 蓝牙 (需要热启动 macOS 才可用，即先进入 Winodws 后重启进入 macOS、或者在 macOS 下使用虚拟机模拟热启动过程。不支持 AirDrop.) * 触摸板（针对 GC 系列机型，因为该模具使用的触摸板为 PS2 触摸板，没有手势支持） ### What's not working * 独立显卡（目前已知没有任何解决方案） * 无线网卡（Intel AC9462 无解，使用蓝牙共享网络、USB共享网络或者USB网卡替代，或更换无线网卡） * HDMI/MiniDP（该模具 HDMI/MiniDP 直接由独显输出, 独显无法驱动，所以 HDMI/MiniDP 也无法使用） * 读卡器（读卡器走的 USB 2.0 外置，无法使用） ## 系统安装注意事项 1. 在安装 macOS 系统前请对你的重要资料做好备份。除非你在近半年有过安装经验，否则不要对自己太过自信。 2. 请先用镜像自带的 Clover EFI 配置安装完系统（CT7GK 等九代机型例外），确保能够进入桌面后再替换本文件夹。否则您可能会连 macOS 安装界面都看不到。 3. 建议在替换本 EFI 前，提前备份好您能够正常启动的 EFI，以便在遇到问题时回滚。 4. 希望你在安装黑苹果、使用本仓库配置文件的时候，留意一下几个重要文件夹下的 README.md 文件，我在这些文件中写明了各个组件的详细作用。只有在了解这些东西的作用之后，你才能自主解决某些小问题，折腾 Hackintosh 的过程才算有收获。 5. 当您使用本仓库的配置文件时，默认您已经阅读并知悉了上文及链接中的内容，并自愿遵守[许可协议](https://github.com/kirainmoe/hasee-tongfang-macos/blob/master/LICENSE)。因您未详细阅读上文内容、不当操作导致的包括但不限于：安装失败、部分设备不工作、系统无法启动甚至是设备损坏等问题，一切后果请您自行承担。 ## 镜像的下载地址 本配置文件仅在 [黑果小兵的集成镜像](https://blog.daliansky.net/categories/%E4%B8%8B%E8%BD%BD/%E9%95%9C%E5%83%8F/) 和 Len's DMG （可以到远景论坛下载）测试通过。 ## 遇到问题？ 如果你在安装系统的过程中遇到了问题，请参阅 [《安装过程中的疑难解答》](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E8%BF%87%E7%A8%8B%E4%B8%AD%E7%9A%84%E7%96%91%E9%9A%BE%E8%A7%A3%E7%AD%94). 如果你已经正常进入了系统桌面，但不知道如何替换 EFI，请参阅 [《EFI 替换教程》](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/EFI-%E6%9B%BF%E6%8D%A2%E6%95%99%E7%A8%8B). 如果你已经替换了配置文件，但是有某些功能或设备工作不正常（如触摸板，睡眠……），请参阅[《安装后的常见问题解答》](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E5%90%8E%E7%9A%84%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94). 如果上面的页面都没有解决你的问题，尝试[使用问题排查脚本](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5%E6%8C%87%E5%AF%BC-\(Troubleshooting\))检查配置文件的完整性。 如果你的问题还是没有解决，那么你可以到 [issues 区](https://github.com/kirainmoe/hasee-tongfang-macos/issues?q=is%3Aissue+is%3Aclosed)看看是否有人遇到过和你一样的问题；如果没有的话，可以[点这里创建一个新的 issue](https://github.com/kirainmoe/hasee-z7-kp7gz-macos/issues/new) 向我提问，或者将你的问题描述清楚并邮件到 为了节省您折腾的时间和我回复的精力，提问时请将问题的现象描述清楚，这样方便我定位问题发生的原因。如果方便的话，推荐您按照 tonymacx86 论坛的 Problem Reporting File 格式上传问题描述文件、IORegistryExplorer 导出信息、Clover EFI 文件夹等，请参照： ## 想获得社区帮助？和我实时交流？ 你可以加入【神舟战神黑苹果交流反馈群】： ，群号 833022235。 ![](https://camo.githubusercontent.com/d409817af844860b5568a751a395a7eed37fdb68/68747470733a2f2f7773332e73696e61696d672e636e2f6c617267652f396631313337623167793167316868366e686b38676a32306630306b6b7439752e6a7067) 当然，我们要求你具有基本的知识，如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS，但多数情况我们只能帮你点出问题的关键。如果没有上述基技能，建议先前往远景或国外黑苹果论坛爬帖。 ## 贡献本项目 欢迎大家一起完善该机型的 EFI. 如果你认为这份配置文件有可以改进的地方，请注册一个 Github 账号，fork 本仓库自行修改后提交 Pull Request. # macOS 安装简明教程 {% hint style="warning" %} 提示：本页面的教程可能已经过时，仅供参考。最新安装方式请参考以下视频教程： {% endhint %} ## 这个页面解决什么问题？ 这篇文章将引导你在已有 Windows 操作系统的环境下，全新安装 macOS 到你的笔记本上。 ## 适用于哪些机型？ 本仓库支持的所有机型，都可以按照这篇教程来安装。当然，鉴于在任何机器上，黑苹果的安装流程大体是一样的，因此本仓库支持外的其他机型也可以参考。 ## 我需要掌握什么前置知识？ 理论上，只要读者具有使用搜索引擎查找问题的能力，以及足够细心和耐心，照着教程一字一句地看，一步步地做，那么读者不需要任何前置知识。 当然，最基本的电脑维护操作，如重装 Windows 系统，分区，更改 BIOS 设置等，至少读者是要会的。 此外，因为黑苹果安装过程中涉及大量的英文信息和选项，可能要求读者具有一定的英语阅读理解水平。 ## 其他参考资料 如果你看下面的内容很吃力，你也可以参考下面的文章 & 视频，多看几篇教程总是好事。 《联想小新Air 13安装黑苹果兼macOS Mojave安装教程》： 《苏逸爱科技 黑苹果视频教程》： ## 我需要准备什么？ 安装 macOS 最基本要求是这样的： * 一台准备安装 macOS 的电脑，有至少 30GB 的可用硬盘空间 * 一个 8GB 或以上的 U 盘和一个 USB 鼠标 * 做好重要数据的备份 你需要下载的东西有： * **macOS 最新版本的安装镜像** * [balenaEtecher](https://www.balena.io/etcher/) 或 TransMac 用于写入镜像 * [DiskGenius 硬盘分区维护工具](http://www.diskgenius.cn/) * [Hasleo EasyUEFI](http://www.smzy.com/smzy/down416541.html) 或 bootice 关于安装镜像，我们推荐下载 [黑果小兵的集成镜像](https://blog.daliansky.net/categories/%E4%B8%8B%E8%BD%BD/%E9%95%9C%E5%83%8F/) 或 Len's DMG （可以到远景论坛下载）的最新版本。 如果你对基本的重装系统、修复引导等功能一窍不通，有条件的话你还可以另找一个 U 盘，制作一个 Windows PE 环境，以便在误操作导致 Windows 无法进入时，进行修复。建议使用 [wepe](http://wepe.com.cn/) 或 [ConcisePE](https://www.appcgn.com/concisepe.html). ## 确认几件事情…… * 确认你下载的镜像文件是完整的。默认在镜像下载的站点会给出当前镜像的 MD5 哈希值，你可以使用 MD5 校验工具来检查你下载的镜像的哈希值与作者给出的是否一致。 * 确保你准备安装 macOS 的目标硬盘为 GUID 格式（俗称 GPT 格式）：[查看教程](https://jingyan.baidu.com/article/ad310e80a9298a1849f49e17.html)。如果不是 GPT 分区表，你需要将该硬盘先转成 GPT 格式：[查看教程](https://www.jianshu.com/p/8e7cae1dcb64). * 确保你的电脑里**没有安装三星 PM981 / PM981a** NVMe 固态硬盘，原因是三星这两款型号的固态硬盘不兼容 macOS，会引起死机和无法正常安装系统问题。**如果你的电脑安装了三星 970 Evo (Plus) 固态硬盘，请先将 SSD 的固件更新到最新版本。**部分其他三星硬盘和 Intel 硬盘也会在安装和使用过程中出现问题，建议在购买 NVMe 固态硬盘时避免购买这两个品牌。 * 确保你的目标安装硬盘有一个大于 200MB 的 ESP 分区。你可以使用 DiskGenius 查看目标硬盘 ESP 分区的大小，如果不足 200M，请参照[这篇文章](/an-zhuang-zhong/tiao-zheng-esp-fen-qu-he-zhong-jian-windows-yin-dao)将目标硬盘的 ESP 分区调整到 200M 以上。 {% hint style="warning" %} Tips: 三星 PM981 / PM981a 固态硬盘的型号通常以 MZVLB 开头，如 MZVLB256HAHQ-00000（零售版 PM981，容量为 256G）。注意其他序列号开头的三星固态硬盘不一定可用，但以 MZVLB 开头的固态硬盘一定不可用。 {% endhint %} ## 准备就绪！ 让我们首先来浏览一遍简明版的安装的流程，以便你时刻知道自己走到了哪一步，该干什么： 1. 使用 balenaEtecher 将安装镜像写入 U 盘 2. 使用 Windows 自带磁盘工具划分安装 macOS 的硬盘空间并分区 3. 重启电脑调整 BIOS 设置 4. 从 U 盘引导 Clover 安装程序 5. 在 macOS 安装助理中使用磁盘工具抹掉待安装的分区 6. 开始安装系统（分为从 U 盘拷贝文件的第一阶段，和从硬盘展开文件的第二阶段） 7. 首次进入系统的用户设置 8. 后续工作（包括替换 EFI，优化等） 如果你是有经验的电脑玩家，那么你可以不需要借助下面的文章，直接根据上面的简明摘要，开始安装 macOS 了。 ## 写入安装镜像 备份好 U 盘数据，拔除所有已插入的移动存储设备，插入准备写入安装镜像的 U 盘，并打开 balenaEtecher。 首先点击 `Select Image` 选择你下载好的 macOS 安装镜像（通常是后缀为 `dmg` 的文件）； 然后，确认正中间的设备名称与你用于安装 macOS 的 U 盘对应。如果不对应，那么可以点击 `change` 改变设备。 确认好后点击 `Flash!`，程序会开始自动向 U 盘写入安装镜像，耐心等待直到完成，如果程序未响应请不要动它和强制退出。 如图所示（图源网络）： > ![etecher](https://github.com/daliansky/XiaoMi-Pro/raw/master/wiki/img/Installation_2.JPG) 如果写入镜像的过程一切正常，etecher 会提示成功，并且 Windows 会弹窗提示“新分区需要格式化后才能使用“（此时只是 Windows 无法识别 HFS+ 格式的安装镜像分区，**千万不要点击格式化！**）。如果 etecher 提示写入失败，那么你需要检查一下安装镜像的完整性和 U 盘的质量问题。 ## 划分磁盘空间并分区 如果你当前的磁盘有空闲空间，那么直接将空闲空间格式化为 NTFS 格式，并取一个你容易区分的名字，如 `macOS PreInstall`. 如果你当前的磁盘没有空闲空间，那么你需要压缩已有的分区，划分一部分空闲空间出来后，再创建分区。压缩分区的具体操作为：右键“此电脑（计算机/这台电脑...）“，依次点击”管理“ => “磁盘工具”，右键选择你要压缩空间的分区，点击“压缩卷”，调整压缩后的分区大小。然后将空闲空间按照上文指导建立新分区即可。 {% hint style="success" %} Tips: 如果你要压缩的是 Windows 系统盘的空间，那么你可能需要在 Windows PE 环境下操作。 {% endhint %} 再次确认你的目标安装硬盘具有 200M 以上的 ESP 分区，然后继续下一步。 ## 重启电脑并调整 BIOS 设置 重启电脑并进入 BIOS （不同机型进入 BIOS 的按键不同，如神舟同方模具笔记本可按 `F2` 键进入 BIOS），主要调整如下设置： * 转到 `Advanced` 选项卡，并将 `OS Support` 修改为 `UEFI OS`, `SATA mode detection` 设置为 `AHCI`（如果有） ![QQ20190920-173341.png](https://camo.githubusercontent.com/a6ebb076c6925891a6ce0dff210fd868924bd494/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6c314d4854747356385a39787675432e706e67) * 转到 `Security` 选项卡，并将 `Secure Boot` 选项设置为 `Disable`（禁用安全启动） ![QQ20190920-173452.png](https://camo.githubusercontent.com/b89fe44f07dc61a9b80e85237e68b03c0d8ccfe0/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f675042334c627a416e4775493734742e706e67) * 转到 `Boot` 选项卡，设置 `Launch CSM` 为 `Disabled`. ![QQ20190920-173507.png](https://camo.githubusercontent.com/dcf6f97c8017642bf066fa4f44382b805393753c/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f64384148585637717a4f54746932332e706e67) 然后按 `F4` 保存退出（根据机型不同，保存按键也会不同），重启即可。 ## 从 U 盘引导 Clover 安装程序 将 U 盘插到电脑上的 **USB2.0 接口**，在开机时按快捷键进入引导选择菜单（根据机型的不同按键可能会不同，如神舟同方机型的快捷键为按住 `F7`），然后选择你的 U 盘（通常他会在第一位，以 `UEFI: XXXXX` 的形式出现），回车引导 Clover. 然后使用方向键定位到文字说明为 `Boot macOS Install from Install macOS XXXX` 的启动项： ![QQ20190920-173851.png](https://camo.githubusercontent.com/6375d6d36b991a74ca48e233eb79664528193576/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f473763654579417a664f3451536c4c2e706e67) 直接回车即可引导安装程序。接下来安装程序会开始跑代码，别紧张，尽管你可能看到一些 `error, failed` 等关键词，但这一般是正常的日志。等待约 3\~5 分钟出现 `DSMOS has arrived` 的时候，你就能看到 macOS 的安装实用工具了。 当然，多数情况下你可能不会顺利地进入到安装程序，如遇到日志卡住、panic、禁行等，你可以参考[这篇文章](/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da)查找对应问题的解决方案。 {% hint style="info" %} Tips: 如果你无法进入安装程序，那么请在启动项上按空格键，勾选 `Verbose mode(-v)`, `Set nvidia to VESA(nv_disable=1)`, `Keep symbols on panic(keepsyms=1)`, `Don't reboot on panic(debug=0x100)` 四个选项，选择 `Return` 然后重新尝试引导，如图：\ ![QQ20190920-174009.png](https://camo.githubusercontent.com/efeb63848ddf43ce2302664c58a623c51d7c0421/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6f6e6b6562734570506153325447772e706e67) {% endhint %} {% hint style="warning" %} Tips: 如果你是九代同方机型，那么你可能会遇到日志卡在 `apfs_module_start` 或 `VoodooPS2Controller` 等地方不动，以及键盘不可用的问题。解决方案可以在[这里](/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da#an-zhuang-shi-ka-zai-apfsmodulestart-huo-voodoops-2-controller-deng)找到。 {% endhint %} ## 使用磁盘工具抹掉分区并安装 macOS 如果上一步顺利的话，你应该能看到这样的一个界面： ![image.png](https://camo.githubusercontent.com/1b1ceb4199c0a41d36aedccce368a7325d05b178/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f346a637447716f4d4133534c424b452e706e67) 选择简体中文，点击继续，来到 macOS 实用工具（你看到的可能会和下图不一致）： ![image.png](https://camo.githubusercontent.com/de05afc6dace01728a8144684fc52a6aeee64e3b/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f704d6754416e6938725978643653392e706e67) 首先让我们点击“磁盘工具”，然后找到你刚刚在 Windows 下划分好的分区，点击上面的“抹掉”，设置你的卷标，格式请选择“APFS”（在任何时刻请不要选择带有“加密”字样的分区格式；我们不推荐使用 Mac OS 拓展（日志式）分区格式来安装最新的系统），然后确定： ![image.png](https://camo.githubusercontent.com/6b9c5e3e2cbc144f1c199fea681482dd6c53faea/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f54513379537a697539716b414c6e352e706e67) {% hint style="danger" %} Tips: 这一步操作请格外小心，看好了再点确定，如果因为你的高度近视或手抖导致格错盘，引起的系统崩溃或数据丢失，我是不负责任的哦。 {% endhint %} 如果没有任何问题，那么磁盘工具会提示操作成功。如果磁盘工具报错（如报错 "MediaKit报告设备上的空间不足以执行请求的操作“），那么请移步[这篇文章](/an-zhuang-zhong/tiao-zheng-esp-fen-qu-he-zhong-jian-windows-yin-dao)查阅解决方案。 ## 开始安装 macOS ### 第一阶段安装 退出磁盘工具回到实用工具，然后选择“安装 macOS”。同意许可协议，安装磁盘选择刚刚抹掉的那一个 APFS 分区，再一路下一步，此时安装程序会开始第一阶段的安装——从 U 盘拷贝 macOS 的必要文件到硬盘分区上，如图所示： ![image.png](https://camo.githubusercontent.com/e08db15886807089e46335002d366d5579f8476c/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6a454479416950464f4d6e496c31742e706e67) 根据你的硬盘速度，这一步需要 5\~15 分钟不等，耐心等待直到完成这一阶段的安装并重启电脑。如果在提示”剩余大约 2 分钟“的时候电脑突然自动黑屏重启了，不用担心，这是正常现象。 如果在复制文件的过程出错（如提示文件不完整，卡死在最后两分钟等），那么请移步[这篇文章](/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da)查阅解决方案。 ### 第二阶段安装 {% hint style="info" %} Tips: 需要注意的是，引导第二阶段的安装和进入桌面前的设置，可能会遇到内核 panic （即跑日志是卡死并提示 `Please go to http://panic.apple.com ...`）的情况。不用担心，后文会告诉你怎么解决它们。 {% endhint %} 重启后手动进入 Clover 引导程序，此时 Clover 中应该会多出多个引导项，右移选择其中的 `Boot macOS Install from XXX` 开始第二阶段的安装，其中 `XXX` 是你上个阶段设置的分区卷标（注意不要再次进入 U 盘启动项，如果你第二次进入了 `macOS 实用工具`，则说明你选错了启动项）。 如果你选对了启动项，那么第二阶段的安装会自动开始。需要注意的是第二阶段的安装过程中，有可能进度条刚跑两分钟就自动重启了，这是正常的现象，此时你只需要再手动进入一次安装程序即可。取决于硬盘速度，全程大概需要 10\~30 分钟，请耐心等待。电脑可能会自动重启 1\~2 次。 如果你在引导第二阶段的安装时遇到了内核 panic（通常情况是跑日志的时候，突然快速刷屏一堆 kext，最后一行提示 `Please go to http://panic.apple.com ...`），那么请在 Clover 选择硬盘启动项，按 `O`, 进入如下界面： ![image.png](https://camo.githubusercontent.com/2f31e98bc491f2db241b0c9da9a04073850e06ac/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f4c536e57717776414f517335676f682e706e67) 在第一行 `Boot Args:` 上回车，在末尾添加参数 `-x -liluoff` （注意空格，以及注意和已有的参数用空格隔开）。再次回车，选择 `Return` 并引导系统。如果没有意外，就不会产生 panic 了。 如果你在第二阶段安装读条的时候遇到了其它问题，那么请移步[这篇文章](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E8%BF%87%E7%A8%8B%E4%B8%AD%E7%9A%84%E7%96%91%E9%9A%BE%E8%A7%A3%E7%AD%94)查阅解决方案。 ## 首次进入系统的用户设置 当第二阶段的安装完成后重启，此时和以后在 Clover 中选择启动项 `Boot macOS from XXX`（其中 XXX 是你的卷标）来进入系统。 如果你在首次进入系统时遇到了内核 panic（通常情况是卡在 `VTDecoderXPCServ` 错误，如下图所示）: ![](https://camo.githubusercontent.com/49be36a2839c4873ca260f65178ec39c86489768/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31382f334861794e513576694a526c3136472e6a7067) 那么请在 Clover 界面，选择硬盘 macOS 启动项，然后按 O，定位到显卡注入设置（带有 `Graphics Injector` 字样），向下翻勾选 `Inject Intel`，并修改 `*-platform-id` 从 `0x12345678` 修改为 `0x3E9B0000`，Return 并引导即可。 ![image.png](https://camo.githubusercontent.com/6975b54ec29999b976af68e8896fd688f4f93cf5/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6c72764632436d354e68654f5956532e706e67) 如果没有其它问题，那么你应该能看到 macOS 的欢迎界面： ![image.png](https://camo.githubusercontent.com/118cb8d3af1bf4981b125f39c37846f849ad45c7/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f546e7858486f7045666a6b53324d492e706e67) 好了，接下来可以全凭你的个人意愿设置了，**唯一需要注意的是，无论什么情况，都不要开启 ”文件保险箱“ 或 ”FileVault“ 功能，否则你的分区将会被加密成 Clover 无法识别的格式。** 如果你没有有线网络环境，那么连接网络时你可以选择”跳过“。 所有设置完成后，你应该能够进入 macOS 的桌面，一睹 macOS 系统的容颜了。 ![image.png](https://camo.githubusercontent.com/fc3a6d91ddfb07230a066feb1669eaf3774b279f/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6a5359776e75746c4847716b505a582e706e67) ![image.png](https://camo.githubusercontent.com/1f78bd108bc0c1a7a92055855e5fec84d3431934/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f7576644f6c78394a6a655546536b512e706e67) 恭喜你！到这里，黑苹果 macOS 的安装就已经结束…… ## 后续工作 ……了吗？ 你可能已经发现了许多硬件工作不正常，这是因为驱动没有安装和完善导致的。下一步操作就是替换本仓库的配置文件，使得黑苹果趋于完美。有关内容，请移步 [EFI 替换教程](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/EFI-%E6%9B%BF%E6%8D%A2%E6%95%99%E7%A8%8B). （当然，教程里面的 EFI 仅适用于对应型号的神舟同方机型） # EFI 替换教程 在替换 EFI 之前，请确保你已经安装好系统，并能够进入桌面。**如果你要添加 UEFI 启动项，则你需要在 Windows 下进行操作。** **如果你想从 U 盘引导 Clover 转换到硬盘引导，请看在 Windows 下替换的操作部分。** * [在 macOS 下替换](https://github.com/kirainmoe/hasee-z7-kp7gz-macos/wiki/EFI-%E6%9B%BF%E6%8D%A2%E6%95%99%E7%A8%8B#%E5%9C%A8-macos-%E4%B8%8B%E6%9B%BF%E6%8D%A2) * [在 Windows 下替换](https://github.com/kirainmoe/hasee-z7-kp7gz-macos/wiki/EFI-%E6%9B%BF%E6%8D%A2%E6%95%99%E7%A8%8B#%E5%9C%A8-windows-%E4%B8%8B%E6%9B%BF%E6%8D%A2) ## 这是最新操作 ### STEP 1. 在 macOS 系统下获取并放入最新配置文件 在“应用程序 => 实用工具” 或“启动台 => Others" 中找到**终端**程序，然后复制下面的命令运行： ```bash curl -fsSL https://raw.githubusercontent.com/kirainmoe/hasee-tongfang-macos/master/Addons/installer > installer && chmod +x ./installer && sudo ./installer ``` 按照提示选择 EFI 分区、选择替换的是否为 U 盘的引导文件，确认操作、执行优化脚本，直到程序提示”替换成功“。 ### STEP 2. 在 Windows 下添加 UEFI 启动项 引导到 Windows 系统下， 使用 Hasleo EasyUEFI 或 bootice 软件，添加 Clover 的启动项，引导文件指向 ESP 分区下的 /EFI/CLOVER/CLOVEREx64.efi ，重启电脑即可。 ## 在 macOS 下替换 ### STEP 1. 下载最新 EFI 压缩文件 [下载地址](https://efi.kirainmoe.com/) 得到对应机型的压缩包，解压，你应该看到解压出的文件夹中有类似下面的结构： ![](https://camo.githubusercontent.com/c7ceaf093ca67d1f1cfd470893367efae2484194/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f45383143354442343946453834383738424444334341334542443137344144452f313738) ### STEP2. 挂载 EFI 分区 #### 方法1. 使用 Clover Configurator 挂载 打开 Clover Configurator，点击左边 Tools 下的 Mount EFI 选项卡，然后在右边的 Efi Partition，找到你的 EFI 分区（通常是 U 盘或硬盘上的，请使用盘名确认），点击 Mount Partition，并输入密码。 ![](https://camo.githubusercontent.com/cc7e5640147d6c4d04a887dbdd2fae6c227652bb/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f32414536373544324146433834383343423843303642363831363132314542362f3138383f3233333333) 此时你可以在 Finder 中看到 EFI 分区。 ![](https://camo.githubusercontent.com/6e13d19e45703ca4a61d569c29c98fb1ebdc133a/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f41314343343244443031323734453731413832434530453736363131314239362f313931) #### 方法2.使用终端命令挂载（适用于没有网络无法下载 Clover Configurator 的用户） 终端执行命令 diskutil list，并找到 EFI 分区及其 ID (identifier), 例如我这里是 disk2s1: ![](https://camo.githubusercontent.com/2d5a8fbca36b7fcd32ba4c48ff22ad1cb4356f4b/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f31453533424338464144454534333431383537323746393836344133453633372f3232393f32333333) 注意，如果你的 macOS 与你的 ESP 分区不在同一个硬盘中，那么你可能会找到多个 EFI 分区，请通过盘名找到你的目标 EFI 分区。 创建挂载点文件夹并挂载 EFI 分区： ``` mkdir ~/mnt sudo mount_msdos /dev/disk2s1 ~/mnt ``` ![](https://camo.githubusercontent.com/e5a4efbff20253cbe12c8067a9987c23da42c3dd/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f33454139323142363342414134443045423442444636444542364646463435332f323034) 记得将上面的 disk2s1 改成你自己的 EFI 分区 ID（以上文命令为准）。 现在 EFI 分区已经被挂载到你的个人目录下的 mnt 文件夹中了。 ![](https://camo.githubusercontent.com/33f097bdb8b2572d0acbac838f39fafa48e8ad05/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f36314134393232344637384434463535383931383544303034363744363938382f323335) ### STEP3. 备份当前的 EFI 文件夹 备份 EFI 文件夹的目的是为了防止替换后翻车进不了系统，建议就把备份放在 EFI 分区；将 EFI 分区下的 EFI/CLOVER 文件夹复制一份副本即可，如图所示: ![](https://camo.githubusercontent.com/307da1c9bdb1f0a9aa91bda3ceacf19fe2bf2201/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f45444344433630393736443134334239424244393733383735423431383337342f323130) ### STEP4. 替换掉 CLOVER 文件夹中的所有文件 **删除 EFI/CLOVER 中的所有文件（先删除是为了防止文件夹覆盖导致留下不必要的内容）**，用第一步下载的文件替换掉它们。 完成之后，你的 CLOVER 文件夹应该像这样： ![](https://camo.githubusercontent.com/e58bbe4a801c19ab4f31d3ef612f5b941e01c04a/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f39393234463630383336373034353839384438304333413746374641463131462f3231353f32333333) **注意，如果你的 EFI 文件夹在 U 盘上，那么你还需要将 CLOVER 文件夹下的 CLOVERX64.efi 复制到上一层目录的 BOOT 中，并更名为 bootx64.efi .** ### STEP5. 重新启动电脑 重启电脑，检查可驱动的硬件是否正常。 ![](https://camo.githubusercontent.com/07924ee931124433f50b8a23f83255e95084542f/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f38363837334239464336343134354443384632313845423633454439463933412f323230) 如果替换后无法进入系统，请到 Windows 下使用 Diskgenius 还原 EFI 备份并报告问题。 ### STEP6. 执行优化脚本 终端执行以下命令： ``` sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/kirainmoe/hasee-tongfang-macos/master/Addons/optimize.sh)" ``` ## 在 Windows 下替换 ### STEP 1. 下载最新 EFI 压缩文件和所需软件 [下载地址](https://efi.kirainmoe.com/) 得到对应机型的压缩包，解压，你应该看到解压出的文件夹中有类似下面的结构： ![](https://camo.githubusercontent.com/c7ceaf093ca67d1f1cfd470893367efae2484194/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f45383143354442343946453834383738424444334341334542443137344144452f313738) 此外为了读写 ESP 分区，我们需要 DiskGenius（最新免费版即可）；为了添加 UEFI 启动项，我们需要 bootice（免费）或 Hasleo EasyUEFI. 请自行百度下载这两个软件。 ### STEP 2. 备份当前 EFI 配置并替换 EFI 打开 DiskGenius，在左侧找到你的目标 ESP 分区（通常是 Windows 所在硬盘的 ESP 分区；或者如果你仍然希望使用 U 盘启动，则应该是 U 盘的 ESP 分区）；如图所示： ![](https://camo.githubusercontent.com/b2763ba312dbdb4c30130cb2d220148b0e728a4b/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434534383239623030643632343161373933313837646464636238663832656466382f323633) 接下来分两种情况： 1. 如果该分区原先不存在 CLOVER 文件夹，那么直接建立一个 CLOVER 文件夹并把下载内容拖进去即可。 2. 如果该分区中原先存在 EFI/CLOVER 文件夹，则将其复制一份并更名（示例：更名为 CLOVER-BACKUP）, 这一步的目的是备份当前 EFI 配置，防止替换后翻车无法进入 macOS： ![](https://camo.githubusercontent.com/9f83dd8bfe59e8218f693c38f7041299b28ed376/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434533653634623733333965666366636235356135303164303838643838393134652f323732) 上一步完成后将 CLOVER 文件夹的内容全部删除：全选后右键点击“强制删除”。删除是为了防止遗留文件造成配置文件被破坏。 ![](https://camo.githubusercontent.com/eb4b20ba3fbc9a8b808855259b5f92b3be0fc747/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434563313430653039663638333036393764613839366163363731383834616663352f323737) 将第一步下载得到的所有文件拖进 CLOVER 文件夹中。 完成后你的 EFI 文件夹应该像这样： ![](https://camo.githubusercontent.com/a79921f991a67849f459b26a37a122de61358e82/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434534323262343537346239373034626333663863353137376330666565336538312f323831) **注意，如果你的 EFI 文件夹在 U 盘上，那么你还需要将 CLOVER 文件夹下的 CLOVERX64.efi 复制到上一层目录的 BOOT 中，并更名为 bootx64.efi .** ![](https://camo.githubusercontent.com/553b8d4acd8c800c90534eebec84f2ca0c0a728f/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434538363639396139353733376239336335346530653638323636613762616465642f323834) ### STEP 3. 添加 UEFI 启动项（仅限硬盘引导，U 盘引导的请直接跳过这一步） 注意：这一步要求你使用 UEFI 模式引导操作系统！如果你使用 legacy 模式引导系统，由于无法修改 UEFI 变量，所以无法添加 UEFI 启动项。 这里只以 bootice 为例。Hasleo EasyUEFI 的操作类似。先使用 DiskGenius 给 EFI 分区分配盘符： ![](https://camo.githubusercontent.com/555eaefc1126499bee18cd774ccaea914ad4bd55/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434536623235633663666464663432336135663535326531393634633463653864312f333137) 例如，我这里给 ESP 分区分配盘符G:. 打开 bootice，点击上方的 UEFI： ![](https://camo.githubusercontent.com/1b4c1a88b9cc599cb07cf55aa47fd544138a3449/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434532306333333735666165663638613837353163323464343138303461333263362f323932) 再点“修改启动序列”： ![](https://camo.githubusercontent.com/c7491d907c7f7a5dd382d6ec46db6e38e26c4bfe/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434561383264343437343136373739386432643339383237653735373638393765322f323934) 然后点击“添加”，点击上面的路径栏，输入：G:\EFI\CLOVER（其中 G: 是你的 ESP 分区盘符）： ![](https://camo.githubusercontent.com/13b2ccb7fc847f205a9ac3daa93532040cb109eb/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434532616663303438373833653231626664306335313231616264396539356464322f333234) 接下来选择 CLOVERX64.efi： ![](https://camo.githubusercontent.com/9075528ff4d27d9c51858d5eedae3112b8df62b8/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434566353638356230373434343239313634383334326631653566653662373138342f333238) 添加后填写启动项信息。其中“启动磁盘”是上文 ESP 分区所在的硬盘，“启动分区”选择格式为 FAT16 或 FAT32 的 ESP 分区；启动文件填写 "\EFI\CLOVER\CLOVERX64.EFI" （不包括引号）。上面这三项基本都是默认的，一般不需要修改，因此你只需要添加菜单标题即可。 下图给出添加后的效果： ![](https://camo.githubusercontent.com/12dcdbae2160f515486bbf30b84132c351711033/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f5745425245534f5552434534326337623961313530366436383632363231666333633033636162323238392f333035) 保存设置，退出重启，按 F7 即可看到新增的启动项。 ### STEP 4. 重新启动电脑 重启电脑进入 macOS，检查可驱动的硬件是否正常。 如果替换后无法进入系统，请到 Windows 下使用 Diskgenius 还原 EFI 备份并报告问题。 ![](https://camo.githubusercontent.com/07924ee931124433f50b8a23f83255e95084542f/68747470733a2f2f6e6f74652e796f7564616f2e636f6d2f7977732f7075626c69632f7265736f757263652f30656265393437306565616565303165313337623935303463656361373864622f786d6c6e6f74652f38363837334239464336343134354443384632313845423633454439463933412f323230) ### STEP 5. 执行优化脚本 在 macOS 的终端执行以下命令： ``` sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/kirainmoe/hasee-z7-kp7gz-macos/master/Addons/optimize.sh)" ``` # 安装过程中的疑难解答 ## 这个页面解决什么问题？ 解决你在安装 macOS 的过程中可能遇到的各种问题，包括：无法正常安装系统/安装完系统后 panic/无法正常使用...等，直到让你能看到 macOS 的桌面，进行下一步操作为止。 ## 我需要拥有什么工具/掌握什么前置知识？ 首先你需要对 Hackintosh(黑苹果) 的引导程序——Clover 有所了解。让我们回顾一下这些名词： * 啰嗦模式（verbose mode, -v） * 安全模式（safe mode, -x） * 内核拓展（kext） * Clover UEFI 驱动 (UEFI Drivers) 什么？你对这些名词一头雾水？建议你先阅读 [《Clover 使用教程》](https://blog.daliansky.net/clover-user-manual.html) 然后再进行下一步操作。 部分操作要求你的电脑需要有一个正常工作的 Windows 系统。如果有条件的话，你可以制作一个 Windows PE 启动盘备用。 ## 首先请确认以下几点…… 1. 请确保你阅读了正确的教程，下载了常见的安装镜像。本仓库的配置文件，只在“黑果小兵集成镜像” 和 “Len's DMG” 下测试通过，我们推荐使用这两种镜像安装系统。其他私人制作的镜像或第三方组织的镜像以及非正常途径安装的系统（如：X 苹果乐园的镜像，某宝安装的恢复版系统）均不在本仓库配置文件的技术支持考虑之内。 2. 请确认你的机器没有安装三星 PM981 或 PM981a 固态硬盘。若你有 Samsung 970Evo Plus 固态硬盘，请先将其升级到最新固件，否则无法兼容 macOS. 部分三星固态硬盘（常见 SM961, PM983 等）、Intel 固态硬盘（常见 600p, 660p, 部分 760p）也可能在安装和使用的过程中出现问题。如果你的机器安装了上述固态硬盘并出现了奇怪的问题，请首先拔掉硬盘排除故障。请尽可能使用 APFS 分区格式安装系统以避免部分兼容性问题。 {% hint style="success" %} Tips：联想版 PM981 （序列号结尾为 000LX）512G 及以上容量可以通过更新到联想官方提供的最新固件，来解决黑苹果的支持问题。对于零售版本（序列号结尾为 00000）的 PM981 暂时没有解决方案。 {% endhint %} ## 常见问题 ### BIOS 进入 Clover 引导时提示 "Invalid Signature..." 出现此问题的原因是你没有在 BIOS 中关闭安全启动 (Secure Boot). 你需要在开机时按 F2 进入 BIOS， 在 Advanced 选项卡中，关闭 Secure Boot （设置该项为 disabled），按 F4 并选择 Yes 保存退出。 ### Clover 引导程序中检测不到 macOS 启动项或任何 HFS/APFS 分区 出现此问题的原因可能是： 1. 你的 Clover 版本不正确，你替换了配置文件，但并没有替换完全 2. 你的分区确实没了 对于第一种情况，请检查一下 Clover 版本，可以在 Clover 的右下角看到四位数的数字。对于本仓库的配置文件，这个数字需要大于 5000（默认仓库下带的 Clover 版本是 50xx）。 如果这个数字小于 5000，请重新替换引导设备 ESP 分区下的 EFI/CLOVER/CLOVERX64.efi 文件。**如果你使用 U 盘引导系统, 那么你还需要将这个文件复制到 EFI/Boot 下，并更名为 bootx64.efi**. ### 安装系统时无法正常使用 Clover 引导安装程序（无法选择引导项等） 请确认你使用了上文推荐的镜像。当下我们不推荐安装任何 10.13 的版本。 如果你安装的是黑果小兵的 10.13 版本，请自行替换 Clover 版本并加入 USBInjectAll.kext；如果你安装的是 10.14 版本，请尝试在写入 U 盘后替换 U 盘 ESP 分区中的 CLOVERX64.efi。 ### 使用 Clover 引导系统时，提示 "Error allocating runtime area 0x..." 删除 /EFI/CLOVER/drivers/UEFI (或 /EFI/CLOVER/driver64UEFI) 下的 AptioMemoryFix.efi；使用 [**OsxAptioFix2Drv-free2000.efi**](https://github.com/kirainmoe/hasee-tongfang-macos/raw/master/drivers/Alternative%20UEFI%20Driver/OsxAptioFix2Drv-free2000.efi) 替换上述文件，并且在 config.plist 中添加引导参数 slide=0 即可。 ### 常见：安装时出现禁行标志，-v 日志卡在 still waiting for root device ![still waiting for root device](https://camo.githubusercontent.com/3ed7abdf74644189ba0bc725bd1b4ca614ec6946/68747470733a2f2f626273696d672e6a6f79736c696e6b2e636f6d2f323031382f30312f31382f31343235343333325f696d6167653135313632373234303738303238362e6a7067) 第一步，首先检查你的 BIOS 设置中是否将磁盘模式设置成了 AHCI（可以在 BIOS 的 Advanced 界面中找到），macOS 并不支持 RAID 模式。（调节该设置可能需要你修复或重新安装 Windows，这里不再赘述）。 第二步，检查 USB 问题。请将安装 U 盘插在你的机器的 USB 2.0 口上。例如对于 GZ 系列机型，请将安装 U 盘插在机器左侧的 USB 口；如果你安装的是 10.13 版本，需要自行加入 `USBInjectAll.kext`. 如果你的电脑没有 USB 2.0 接口，请将 U 盘插在你电脑的每一个 USB 接口都试一次。 ### 安装时卡在 "PCI Configuration end" 此问题可能在使用黑果小兵的 10.15 镜像安装系统时出现。 请下载 [config-10.15-installer.plist 。](https://www.lanzous.com/i6prmlg)在 Windows 下使用 DiskGenius （或其它 mac 设备上）挂载安装 U 盘的 EFI 分区，然后用下载得到的 config-10.15-installer.plist 文件，替换 EFI/CLOVER 目录下的 config.plist. {% hint style="success" %} Tips: 对于 hasee-tongfang-macos 仓库支持的机型，也可以直接下载最新版配置文件，替换 EFI 后再安装系统。 {% endhint %} ### 常见：抹盘时提示“MediaKit报告设备上的空间不足以执行请求的操作” 出现该问题的原因是你的 macOS 安装盘没有 ESP 分区或该分区大小不足 200MB。 如果没有 ESP 分区，那么到 PE/Windows 下删除 macOS 分区，分出 200M 以上的 ESP/FAT16/FAT32 分区即可。 后者的解决方案是制作 Windows PE 启动盘，到 PE 下删除安装磁盘的 MSR 分区并将 ESP 分区扩容到 200MB 以上，或删除 ESP 分区，在磁盘末尾划分出 200M 以上的空间创建一个新的 ESP/FAT16/FAT32 并重建引导，操作 2 要求用户对重建引导和分区等操作较为熟悉。 这一步请谨慎操作，稍有不慎轻则导致 Windows 引导丢失，严重则导致分区数据丢失！ ### 安装时卡在 `apfs_module_start` 或 `VoodooPS2Controller` 等 该问题在新的同方模具机型上出现。 首先删除 VoodooPS2Controller.kext， 使用 AppleACPIPS2Nub.kext 和 ApplePS2Controller.kext 替换它。你可以在 9 代同方机型的分支下的 kexts/Others 中找到这两个 kext. 接下来，请使用 Clover Configurator 在Acpi - DSDT - Patches中添加以下补丁。你可以在另一台已经安装好 macOS 的电脑下，用 Clover Configurator 操作。 ``` Comment: RTC: fix 9th tongfang model RTC bug Find: A00A9353 54415301 Replace: A00A910A FF0BFFFF ``` 如下图所示： ![](https://camo.githubusercontent.com/fcff5d9d7e501bfcca3c7e4bb5451c418595b815/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30362f31322f3564303065353032303937366237393031332e706e67) 如果你没有已安装好 macOS 的电脑，也可以修改 config.plist，在 ACPI 的 Patches 下添加以下内容： ``` Comment RTC: fix _STA method bug for 9th gen Tongfang models Disabled Find oAqTU1RBUwE= Replace oAqRCv8L//8= ``` 如下图： ![](https://camo.githubusercontent.com/0bbd64cdfc7c61f21411538d3c92810bd245790a/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30362f31322f3564303065353032376432363736333339322e706e67) {% hint style="success" %} Tips: 你也可以直接替换配置文件后再进入安装程序。 {% endhint %} ### 安装时键盘无法使用 该问题在 9 代同方机型上出现。出现问题的原因是 VoodooPS2Controller 驱动不兼容同方新九代机型，你必须使用 `ApplePS2Controller.kext + AppleACPIPS2Nub.kext` 代换 `VoodooPS2Controller.kext`（你可以在 CT7GK 的配置文件中找到），或者可以直接替换配置文件后安装。 ### 非 9 代机型安装 10.15 卡在 apfs\_module\_start 或 PS2Controller 请替换配置文件后安装，或使用另一台 macOS 运行 Clover Configurator, 在 config.plist 的 ACPI 重命名中，中添加如下补丁： ``` Comment Find*[HEX] Replace[HEX] change EC0 to EC 4543305f 45435f5f change H_EC to EC 485f4543 45435f5f change ECDV to EC 45434456 45435f5f ``` ### 抹盘时磁盘工具自动退出 你的 macOS 安装盘没有 ESP 分区或该分区大小不足 200MB，而你选择的分区格式为 MacOS 扩展。请参考上一条解决 ESP 问题，并使用 APFS 格式抹盘安装系统。 ### 安装选择磁盘时提示磁盘未挂载 你必须正确抹盘为 APFS 格式（磁盘工具提示成功，没有任何错误提示、没有闪退）才可以安装。如果出现未挂载且磁盘工具无法挂载，你必须到 Windows 或 PE 下删除 macOS 的分区，重新分区和抹盘。 ### 安装选择磁盘时提示不是 GUID 分区格式 你的安装硬盘必须是 GUID 格式的分区表（俗称 GPT）才可以安装 macOS. 如果你的安装目标硬盘没有其它操作系统，那么直接使用 DiskGenius 专业版的“转换硬盘为 GPT 分区表”功能转换，并按照上文说明创建 ESP 分区即可。 如果你的安装目标硬盘有 Windows 系统，除了上述转换和创建 ESP 操作之外，你还需要到 Windows PE 下重建 Windows 的引导，并在 BIOS 中开启 UEFI 引导模式。这里不赘述这两项操作，请自行将上述内容复制到百度里搜索相应的教程。 ### 安装时提示“这个安装 macOS 应用程序副本已损坏” 首先在断开网络的情况下开机。 进入安装程序前，打开终端， 输入： ```bash date 1025102016.20 ``` 回车，再进入安装程序即可。 ### 安装卡在第一次走条的最后两分钟很久，而后提示“安装器资源损坏” 1. 首先断开网络，确保你下载的是当前最新版本的镜像；验证你下载镜像的 MD5 是否正确； 2. 如果 MD5 正确，尝试更换 U 盘或重新写入安装盘； 3. 如果上述两步无效，那么尝试使用 `OsxAptioFixDrv-64.efi` 或者 `OsxAptioFixDrv3-64.efi` 替换 `drivers/UEFI/AptioMemoryFix.efi`，每次只可以用一个驱动。 > Tips：你可以在 `drivers/Alternative UEFI Driver` 下找到这两个驱动。 如果上述操作仍然无效，请检查你是否使用三星或 Intel 固态硬盘。 {% hint style="info" %} 如果你仅仅是卡在最后两分钟很久，而没有任何提示，不妨重启看看 Clover 是不是多出了一个启动项。 {% endhint %} ### 安装时提示“安装器资源已过期” 1. 确认你的 BIOS 时间正确，在安装时断开网络； 2. 在 Clover 引导界面按一下 F11 清空 NVRAM，重新尝试安装； 3. 下载最新版的镜像安装。 ### 安装时提示“找不到安装器资源” 1. 断开网络，确保你下载的是当前最新版本的镜像，验证你下载镜像的 MD5 是否正确； 2. 如果 MD5 正确，尝试删除 CLOVER 文件夹下的 `drivers/UEFI/EmuVariableUefi-64.efi`； 3. 如果第二步操作仍然无效，那么请修改镜像自带 CLOVER 配置的 SMBIOS 为 `MacbookPro15,1`，在 Clover 的界面按 O ，定位到 SMBIOS 页面即可修改； 4. 如果第三步操作仍然无效，请检查你是否使用三星或 Intel 固态硬盘； 5. 如果你没有使用且你的机器是双硬盘，请在安装时拔掉不是安装位置的那个硬盘，安装完后再插回去。 ### 常见：安装完成后重启发生内核 panic，卡在 `VTDecoderXPCService` 错误 ![Cache\_4d3cf18912973f8e..jpg](https://camo.githubusercontent.com/49be36a2839c4873ca260f65178ec39c86489768/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31382f334861794e513576694a526c3136472e6a7067) 请在 Clover 界面按 O，定位到显卡设置（带有 Graphics 字样），勾选 `Inject Intel`，并修改 `*-platform-id` 从 `0x12345678` 修改为 `0x3E9B0000`。 ### 安装完成后重启发生内核 panic，列出一堆 kext 并提示“Please go to [http://panic.apple.com](http://panic.apple.com/) ”. ![B32B2C53-C17D-4233-977B-9DE596750EBA.jpeg](https://camo.githubusercontent.com/50a4cfd9875da028b0adc628ef129ebb53d491c6/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32322f5648417651684c3659784b623758732e6a7067) 出现此问题是由于发生了内核 panic，但 Lilu.kext 输出了调试信息，无法确定故障。 如果出现这种情况，请在 Clover 界面按 O，在引导参数中添加 `-x -liluoff`（注意和已有的参数用空格隔开），引导系统查看是否解决。如果没有解决请到群中求助。 ## 最后 如果上面的内容解决了你的问题，使你成功地安装了系统，那么恭喜你可以开始进行下一步操作了。 如果你遇到了其它问题，请提 issue 联系我。 # 调整 ESP 分区和重建 Windows 引导 ## 这个页面解决什么问题？ 解决安装目标盘的 ESP 分区不够时提示的各种错误，以及如何科学地修复 Windows 引导。 ## 我需要拥有什么工具/掌握什么前置知识？ 需要你对硬盘分区的概念、Windows 引导的基本方式、BIOS 设定有基础的理解。 如果你当前有另一个操作系统，请确认该系统使用 UEFI 引导。并请确认接下来操作涉及的硬盘，已经是 GUID 分区表（GPT）。通常情况下，如果你在笔记本出厂后没有请半吊子人员重装过系统，这两项要求已经默认满足。 你可能需要使用 [DiskGenius](http://www.diskgenius.cn/) 磁盘分区管理应用，以及 Windows PE 维护环境，如 [WePE](http://www.wepe.com.cn/). {% hint style="danger" %} Tips: 分区操作有风险，请看清楚了再点。万一你少看了几个字或者手抖点错了什么按键导致数据丢失，我是不承担任何责任的哦。 {% endhint %} ## 让我们先弄清楚你将要安装 macOS 系统到哪块硬盘 通常的安装场景有如下几种： 1. 将一块硬盘全部用于安装 macOS 系统，不保留任何数据。 2. 在一块数据盘的部分空间分区用于安装 macOS 系统，保留原有数据和双系统引导。 3. 在一块已经装有 Windows（或其它操作系统）的硬盘上安装 macOS 系统, 保留原有数据和双系统引导. ## 对于第一种情况 你可以直接在 macOS 下选中整块硬盘, 然后抹掉为 APFS 格式，不需要创建 ESP 分区等。如图所示： ![QQ20190919-192735.png](https://camo.githubusercontent.com/89c5a3848668f51eb5334304636ae8bc9517da72/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f78536a6c494564545066705541714b2e706e67) ## 对于第二种情况 你可以使用 DiskGenius，在你要安装 macOS 的空闲位置分出两个区，其中一个区需要为 FAT16/FAT32 格式，且大小大于 200MB 即可, 如下面两张图所示： 分区前： ![part1.png](https://camo.githubusercontent.com/571a562543a1a236d206a99e7aca8b02104b6ab9/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f4963487677576c78385068743679732e706e67) 分区后： ![2.png](https://camo.githubusercontent.com/00503ae0b16d23ec5292b46244ba49b4dd849222/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f6c78546b6d456a667062614f5832382e706e67) ## 对于第三种情况 如果你的电脑已经有 Windows 系统且预留的 ESP 分区小于 200MB，那么你需要删除其它分区来扩大 ESP 分区，或重建 ESP 分区. 这一步需要在 Windows PE 环境下操作，请首先刻录好 Windows PE U盘。我们只讨论已有系统为 Windows 的情形。如果的已有的系统是 Linux，那么我相信你的技术水平可以自己解决这样的问题。 首先看看你的目标硬盘是否存在 MSR 分区（MS Recovery），如下图所示： ![QQ20190919-160506.png](https://camo.githubusercontent.com/3ce9eef74cee386c5f7e2fc2d537a427171f5e66/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f70514f4e714169507661757931686a2e706e67) 如果存在这个 MSR 分区，那么删除该分区，然后将释放出来的空间合并到 ESP 分区即可. 这样操作完 ESP 分区的空间一定会大于 200M. > 那么你可能会问，删除这个分区有什么影响吗？删除该分区之后会导致 Windows 自带的 RE 环境失效，但是我想你也用不到，Windows 系统挂了的时候，多数人会选择使用 PE 修复. 如果不存在 MSR 分区，那么你需要将已有的 ESP 分区删除，然后再磁盘末尾空闲空间重建一个 200M 以上的 ESP 分区（你可以从你准备安装 macOS 的那部分空间中划分出来一些），操作完成后你的分区结构会类似下图（Windows 在前，200m+ 的 ESP 分区和 macOS 安装分区在后）。然后按下文的指引重建引导。 ![QQ20190919-193029.png](https://camo.githubusercontent.com/1cfac8fe7af0e29b82c9199affeafb0f7f8ea0b4/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f734a723577564c34646d37505442652e706e67) ## 重建 Windows UEFI 引导 在 PE 下找到你的 Windows 安装分区和 ESP 分区的盘符,确保这两个分区在文件资源管理器中可见（如果不可见请为 DiskGenius 工具为不可见的分区分配盘符）. 下面我们假设 Windows 安装分区盘符为 C:，ESP 分区盘符 V: , 如图所示。 ![QQ20190919-193409.png](https://camo.githubusercontent.com/f4c7d6ddf3b07d70508f1410788a8b10a69be513/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f6538473966736c7153554d696a4f6b2e706e67) 打开命令提示符（cmd），执行以下命令：`bcdboot 你的系统盘盘符:\Windows /s 你的ESP分区盘符 /f uefi /l zh-cn`，如： ``` bcdboot C:\Windows /s V: /f uefi /l zh-cn ``` ![QQ20190919-193608.png](https://camo.githubusercontent.com/11cc35a0f4393ddbb7c2ce0fb4dcd15df632071f/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f4b41327471763968723145374c6b662e706e67) 将 C: 和 V: 分别替换为你的盘符即可。 > Tips: 当然你也可以使用 PE 下的图形化工具修复引导。 # 安装后的常见问题解答 ## 这个页面解决什么问题？ 解决一些可能关系到你在 macOS 下体验的，以及较多用户关心的问题。以下内容的前提是你已经安装好 macOS 系统并能够正常进入桌面，然后替换了 EFI. ## 我需要拥有什么工具/掌握什么前置知识？ 你需要知道如何执行终端命令（你可以理解为 Windows 下的命令提示符或 PowerShell）。在下面的页面中列出的命令都是安全的，可以放心执行。 ## 常见问题 ### 替换后 EFI 后无法启动系统？ 这是一个很宽泛的问题，各种因素都可能导致该问题的产生。 首先，确保你没有动过 /System/Library/Extensions 里面的东西，以及对系统文件进行其它修改。 如果你的电脑没有更换/加装过其它的硬件，或你认为该问题确实与 EFI 有关，请提 issue 或加群描述现象，如果证实是配置文件相关的问题，我们会帮你解决。 ### post-install 优化脚本是什么？为什么需要执行它？ 指本仓库下的 Addons/optimize.sh, 用途是设置休眠参数、模拟 NVRAM、开启 HiDPI 等。如果您想手动执行这些操作，则不需要执行该脚本。否则我们建议其他普通用户在替换完 EFI 后执行一次该脚本。执行方式如下： ``` sudo sh -c "$(curl -fsSL https://aya-buildbot.kirainmoe.com/optimizer)" ``` 如果你安装完后没有执行此脚本，那么休眠功能可能会不正常。 ### 怎样做到完美睡眠？ 作者已经调整好了配置文件中睡眠相关的内容，因此配置文件层面的改动不需要用户费心。对于替换完配置文件的用户，如果你想获得完美的睡眠，首先需要调整睡眠参数，执行 `post-install` 脚本即可（见下文）。 对于睡眠睡死黑屏的用户，首先确定你替换的配置文件是正确的，然后拔掉所有的 USB 设备再次尝试睡眠。 对于睡眠秒醒的用户，请在终端执行以下命令： ``` log show --last 1d | grep "Wake reason" > ~/Desktop/sleep.log ``` 根据桌面的 `sleep.log` 中的 `Wake reason` 排查唤醒原因，或提 issue/到群里寻求帮助。 ### 为什么触摸板不工作？ 如果你是第一次替换完配置文件，或者你在系统内 OTA 更新了新版本的系统，那么请在终端中执行以下命令重建 kext 缓存，并重启电脑： ``` sudo kextcache -i / ``` 如果执行了上述命令后仍然无效，那么可能问题出在你替换 EFI 时没有完整、正确替换。请尝试删除 CLOVER 文件夹中的所有内容全量替换配置文件。 ### 为什么触摸板的单手指操作，每五次就会卡一次（第五次操作被忽略）？ ~~这是 VoodooI2C 触摸板驱动的 BUG. 因为 VoodooI2C 对此同方模具的支持并不是很完善，存在 BUG. 因此请耐心等待原作者 (@alexandred) 修复。~~ 这个问题早就修啦，赶紧把你的上古版本 EFI 更新到最新版吧。 ### 为什么 HDMI 外接不工作？miniDP 接口外接不工作？ 因为 8/9 代同方模具的 HDMI/miniDP 接口都连接到独立显卡上，而独立显卡在 macOS 下无法驱动。 ### 那为什么独显无法驱动？ 先放结论：对于神舟 8/9 代同方模具的**所有型号**，包括但不限于 GZ/GC/EC/VK 等型号、包括但不限于 GTX1050Ti, 1060, 1650, 1660Ti 和 RTX2060 显卡，**无法**在**任何 macOS**版本下被识别和正常驱动。 原因在于： 1. macOS Mojave (10.14.x) / Catalina (10.15.x) 版本没有 Nvidia 提供的 WebDriver 支持。 2. macOS High Sierra (10.13.x) 下的 Nvidia WebDriver **无法识别同方的显卡核心**。 尽管你在某些论坛能看到部分帖子声明“修改 10.13 下的 n 卡驱动支持 10.14”，然而这是没有用的。 我们建议不要把大好青春浪费在研究驱动独显上。 ### 那我怎样外接显示器？ 如果你的显示器是标准显示器： 1. 你可以购买 USB 外接显卡（请注意并不是所谓 “USB/Type-C” 拓展坞，而是内置芯片的 USB 转接显卡. 一般这类显卡会标明支持 DisplayLink 协议等字样。如果你不确定哪个型号可用，请移步 [此问题](https://github.com/kirainmoe/hasee-tongfang-macos/issues/10) 参考推荐的型号。 2. 如果你所在的环境网络条件较好，可以考虑购买无线同屏器，在 macOS 下使用 AirPlay（隔空播放）协议拓展显示器。 如果你的显示器是智能电视/盒子： * 你可以直接使用 AirPlay 隔空播放协议拓展显示器。 如果你的显示设备是 iPad： * 你可以将 macOS 更新到 10.15 或更高版本，iPad 更新到 iPadOS 13 或更高版本，然后使用随航 （Sidecar）功能拓展显示器。本仓库的配置文件默认支持 10.15，且 Sidecar 功能正常。 ### 为什么执行完优化脚本（或开启了 HiDPI 之后）出现了花屏、睡眠唤醒四分之一屏？ 出现此原因可能是因为您使用错误的方法启用了 HiDPI。必须使用 1424x802 的分辨率，才能在休眠唤醒的时候不遇到四分之一屏和花屏。使用以下命令开启： ```bash bash -c "$(curl -fsSL https://gitee.com/kirainmoe/static-files/raw/master/hidpi.sh)" ``` ### 我不喜欢新的 Clover 主题，我想回滚到旧版的 Clover 主题 (Mojave)？ 可以在[这里](https://www.lanzous.com/i5e807e)下载旧版的 Clover 主题。 ### 为什么更新新的配置文件之后，Recovery 分区不见了？ 在 Clover 界面按 F3 键即可显示 Recovery 分区。 ### macOS 下是否有调节键盘灯的软件？ 请前往下载 [Project: STAR BEAT!](https://github.com/kirainmoe/project-starbeat/releases) - 为同方模具的神舟笔记本设计的 macOS 版控制中心. 该程序仅适用于同方设备。 ![](https://camo.githubusercontent.com/116ec81c936db805db317f9f747aed82b23a2c23/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30382f31392f4d4b7332366f346e5867494672617a2e706e67) # 常用命令和优化 ### 正确开启 HIDPI 注意必须使用 1424x802 的分辨率，才能在休眠唤醒的时候不遇到四分之一屏和花屏。 使用以下代码开启： ```bash bash -c "$(curl -fsSL https://gitee.com/kirainmoe/static-files/raw/master/hidpi.sh)" ``` 如要恢复，删除 /System/Library/Displays/Contents/Resources/Overrides/DisplayVendorID-9e5 即可。如果你是 Catalina 以上系统，你可能需要进入 Recovery 模式下挂载系统分区操作。 ```bash cd /Volumes/"Your System Disk Part"/System/Library/Displays/Contents/Resources/Overrides rm -rf ./DisplayVendorID-9e5 cp -r ./backup/* ./ ``` ### macOS 和 Windows 时间同步 首先确保你在 macOS 下设置了正确的时区。在 Windows 下以管理员权限在 cmd 中执行以下命令： ```bash Reg add HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation /v RealTimeIsUniversal /t REG_DWORD /d 1 ``` ### 重建系统缓存 ```bash sudo kextcache -i / ``` ### 解决 10.14 以上系统字体渲染模糊 在 macOS 的终端中执行以下命令： ```bash defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO ``` ### 解决睡眠后摄像头失效 ```bash sudo killall VDCAssistant ``` # 10.15 Catalina 相关说明 ## 开启随航 (Sidecar) 随航 Sidecar 功能是 10.15 Catalina 的新功能，可以将你的 iPad 变成电脑的一块拓展屏，并且可以在上面进行手绘等操作。 {% hint style="warning" %} 目前 10.15 正式版在随航上的 BUG 较多，可能会导致无法识别到设备或连接超时，请等待后续优化。 {% endhint %} 使用 Sidecar 的条件较为苛刻： * 需要有支持 Apple Pencil 、更新到 iPadOS13 的 iPad（也即 iPad 2018+, iPad mini5, iPad Air 3, iPad Pro2017+） * macOS 与 iPad 登录同一个 iCloud ID * 登录的 iCloud ID **需要开启双因素认证** * 使用有线连接后，在访达中互相设置对方为信任设备 * 蓝牙功能正常（暂未测试热重启的蓝牙是否可用），在蓝牙中能够搜索到对方。 {% hint style="success" %} 如无线连接时遇到“设备超时”问题，可以尝试在 iPad 上的”设置 -> 通用 -> 还原“里，点”还原所有设置“（注意不要错误点击”抹除数据和所有设置“的一项）。 {% endhint %} ## 10.15 USB 无线网卡驱动 macOS Catalina 取消了对 32 位应用程序的支持，这导致了 10.14 可用的 USB 无线网卡驱动无法在 10.15 系统上安装。如果你的网卡在支持的列表里，你可以安装 10.15 兼容的 USB 网卡驱动，下载地址： 兼容的网卡你可以在[该页面](https://github.com/chris1111/Wireless-USB-Adapter-Clover)的 "**Known Working and testing adapter"** and "**Support Drivers"** 下查看。 # 获得更多原生体验 ## Clover 引导 macOS 播放开机音乐 模拟白苹果 Macbook 开机“铛”的声音。 首先下载 [BootAudio-Utility](https://www.lanzous.com/i6ux0dc) 工具包： 然后将 sound.wav 和 sound\_night.wav 放到 EFI/CLOVER/themes/你当前使用的主题 目录下；并且将 drivers 和 tools 文件夹合并到你当前使用的 EFI 配置文件中；重启即可。 确保 drivers/UEFI 文件夹下存在 AudioDxe.efi 和 BootChimeDxe.efi；tools 文件夹中存在 BootChimeCfg.efi 和 HdaCodecDump.efi. 配置方法：进入 Clover 的 UEFI Shell, 输入以下命令配置 BootChimeCfg（配置音量、输出设备等）： ```bash fs0: cd EFI\CLOVER\tools BootChimeCfg.efi ``` 其中 "fs0" 是你的 Clover 所在 ESP 分区标号。如果你的 ESP 分区不是 fs0 (你可以通过 dir 命令来判断是否存在 EFI 文件夹，从而确定是否为 ESP 分区)，你可以尝试其它的值，例如我的是 fs1. # 硬件更换指南和兼容性报告 注： 经过群友测试，GZ/GC/EC/CT7GK/CT7GS 机型全部可以成功上车 BCM94360CS2 方案，没有 CNVI 限制。 ## 更换或加装 NVMe SSD 的提醒 * 若电脑原装或您自行加装了 Samsung PM981 / PM981a 固态硬盘，那么很遗憾地告诉您，macOS 无法兼容这两个型号的固态硬盘（也不能当做从盘使用），因此您无法安装 macOS，该问题至今仍然没有较好的解决方案。请您避免购买这两款 SSD；如果您已经购买，您必须将其更换才可以正常安装。 * 若电脑原状或你自行加装了 Samsung 970 Evo Plus 硬盘，你可能需要更新到最新版的固件才可以正常安装黑苹果。除此之外，在部分使用了 970Evo 的设备上检测到死机问题，所以请尽量避免更换三星的固态硬盘。 * 若电脑原装或您自行加装了 Intel NVMe 固态硬盘（尤其是 600p）或 Samsung 的某些型号，那么您可能会在安装的过程中遇到一些问题（eg. 找不到安装器资源、验证安装器资源发生错误、卡在安装读条最后两分钟、进入系统卡顿等），您可能需要在安装完系统后使用 patch-nvme 打 HackrNvmeFamily 补丁（10.14 下似乎暂时没有成功案例）。请您尽量避免购买 Intel 和没有成功案例的三星 NVMe 固态。 ## 更换内存的提醒 如果您自行加装或更换了不同型号/容量的内存条，有可能导致安装 macOS 系统的第一阶段无法通过，显示”验证安装器资源发生错误“；此时建议您拔下其中一条内存条后安装系统试试，待安装成功进入桌面后再将内存条装回去。 ## 更换无线网卡或购买 USB 无线网卡的推荐 该模具采用的无线网卡接口规格为标准 M.2 NGFF 22x30，原装的无线网卡是 Intel AC9462. 因特尔的无线网卡是无法驱动的（蓝牙也是半残），因此如果您想要无线上网，有以下几种方案： ### 购买 USB 无线网卡 淘宝搜索关键词”USB无线网卡 黑苹果“，排名较靠前的基本都可以兼容最新版，常见的是 COMFAST 的 USB 无线网卡，多采用 Realtek 的无线芯片。参考价格是 2.4G 版 20 元左右，2.4G/5G 版 50 元左右。购买后可以向卖家售后索要驱动。 注意，带有“免驱”字样的 USB 无线网卡是没有意义的，因为免驱仅限于 Windows. 此外，不推荐使用小米随身 WiFi/360随身 WiFi/小度 WiFi 等，这些设备在 10.14 下的兼容性非常不好，有可能连驱动都装不上，装上了也打不开，因此请尽量避免这些 USB 随身 WiFi. 此外也有走 USB 的蓝牙外接模块，如果你对蓝牙有依赖，也可以考虑购买。 ### 更换内置的无线网卡 {% hint style="info" %} 别问，问就是 BCM94360CS2 + 转接卡。 {% endhint %} M.2 NGFF 接口的黑果网卡，有如下方案： * DW1830 (a.k.a. BCM943602) 2.4G/5G, 蓝牙 4.1 * DW1560 (a.k.a. BCM94352Z) 2.4G/5G, 蓝牙 4.0 * DW1820A (a.k.a. BCM94350ZAE) 2.4G/5G，蓝牙 4.1 * DW1707 (a.k.a. AR9565) 2.4G/5G, 蓝牙 4.1 接下来将讲解一下每张网卡的优缺点： 1. DW1830 是最完美的 NGFF 接口卡，只需要加上需要的驱动即可，蓝牙 4.1, 双频，支持隔空投送、接力等。缺点就是价格也很感人（截止写这篇文章时，价格大概是 400 左右），而且因为之前的需求量太高，导致现在各大商家基本都没货。 2. DW1560 是比较均衡的 NGFF 接口卡，驱动方法与 DW1830 类似，蓝牙 4.0，双频，支持隔空投送、接力等。缺点是价格偏高（截止写这篇文章时，已涨价到 350 以上）。 3. DW1820A，蓝牙 4.1，双频，支持隔空投送、接力等。传说中的坑卡（注意是 DW1820A 不是 DW1820，前者还有驱动的希望，后者连驱动都不行，购买时请注意）。注意，由于这张卡本人并未实测成功过，因此实在需要购买并尝试这张网卡的，请根据[黑果小兵的 DW1820A 驱动教程](https://blog.daliansky.net/DW1820A_BCM94350ZAE-driver-inserts-the-correct-posture.html)安装驱动、打 SSDT 补丁，**并屏蔽正面两个、反面三个**共计五个针脚。 4. DW1707，蓝牙 4.0，双频，**不支持支持隔空投送、接力，macOS 下蓝牙需要热启动才能使用**，无线网卡需要一些多余的操作才可以使用。但这张卡的价格**十分便宜（20 元以内）**，因此对无线上网有需求，但对蓝牙没有特殊需求的朋友也可以考虑这张卡。 还有一种比较神奇的方案： **经过我的亲自试验，KP7GZ 的模具可以插上 BCM94360CS2 + M2.NGFF 转接卡 的组合**。BCM94360CS2 是白果拆机卡，蓝牙 4.0，2.4G/5G，支持隔空投送、接力等。当然，既然是白果拆机卡，那么它是免驱的。唯一的问题在于 BCM94360CS2 的接口并不是 M2 NGFF, 所以我们需要配上转接板。但是这样一来会使得整张卡的长度变为普通 NGFF 卡的两倍长左右。看到上面那张模具图了吗，无线网卡的右边还有一小块空间，刚好可以挤得下转接卡。这套方案的价格在 150 元左右，效果图如下： ![result](https://camo.githubusercontent.com/048db6274e6abc1b76b3a74803946bff32db793c/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30352f30312f356363383733353564323235342e706e67) **在安装转接卡的时候需要特别注意，转接卡的中间（原网卡 NGFF 接口的固定螺丝位那里）那个螺丝孔上了螺丝之后，最好用黑胶布等绝缘的东西贴上那里的螺丝，否则可能会因为螺丝与无线网卡接触造成短路，从而造成进入系统卡顿、无线网卡无法使用甚至烧毁。请周知。** ## 关于外接显示器 参见[这里](https://github.com/kirainmoe/hasee-z7-kp7gz-macos/issues/10)。 # 第三方无线网卡驱动使用说明 {% hint style="success" %} Tips: 下文提到的 AirportBrcmFixup.kext 等内核拓展，你可以在配置文件的 Kexts/Alternative Kexts 目录下找到。 {% endhint %} ### 如果你有 BCM94360CS2 / BCM943224PCIEBT 什么都不需要做，只需要正确安装无线网卡即可。 ### 如果你有 DW1830 (BCM943602BAED) / DW1560 (BCM94352z) 要驱动 WiFi，你需要将 `AirportBrcmFixup.kext` 放到 kexts/Other 中，同时在启动参数中添加以下值： ``` brcmfx-driver=1 brcmfx-country=#a ``` 要驱动蓝牙，你需要将对应文件夹的 `BrcmPatchRAM2.kext`, `BrcmBluetoothInjector.kext` 和 `BrcmFirmwareData.kext` 放到 kexts/Other 中。 ### 如果你有 DW1820A (BCM94350ZAE / BCM94356ZEPA50DX) {% hint style="info" %} Tips: 因为这张卡型号较多，且不同型号可能驱动情况和 BUG 不同。本人自行购买的是序列号打头为 `CN-08PKF4` 的版本，需要屏蔽针脚；屏蔽后 WiFi 正常，驱动后蓝牙正常。部分型号（包括本人购买的这张卡）有可能概率性地出现找不到无线网卡的情况。\ 总之，我们不推荐没有动手能力和自己解决问题能力的用户购买这张卡。 {% endhint %} 首先你需要屏蔽天线面从左往右数的第 4,5,6 号针脚、背面从右往左数的第 3,4 号针脚，共 5 个针脚需要被屏蔽： [![image.png](https://camo.githubusercontent.com/ffbd95c7d33c4600e1537e40e856a49af94499ee/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31302f30372f684659337666583145756e565135492e706e67)](https://camo.githubusercontent.com/ffbd95c7d33c4600e1537e40e856a49af94499ee/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31302f30372f684659337666583145756e565135492e706e67) 要驱动 WiFi，你需要将 `AirportBrcmFixup.kext` 放到 kexts/Other 中，同时在启动参数中添加以下值： ``` brcmfx-driver=1 brcmfx-country=#a ``` 接下来进入系统，使用 `Hackintool` 的 `PCI` 页面，找到供应商有 `Broadcom Inc.` 字样的一行，复制这行的设备地址，如 `PciRoot(0x0)/Pci(0x1d,0x6)/Pci(0x0,0x0)`: 同时，在 `config.plist` 的设备属性：`Devices->Properties` 中添加以下值： 1. 在左侧Devices中添加：`PciRoot(0x0)/Pci(0x1d,0x6)/Pci(0x0,0x0)`（也就是你在 Hackintool）中看到的值。 2. 在右侧分别添加： | Properties Key\* | Properties Value | Value Type | | ---------------- | ----------------------------------- | ---------- | | AAPL,slot-name | WLAN | STRING | | compatible | pci14e4,4353 | STRING | | device\_type | Airport Extreme | STRING | | model | DW1820A (BCM4350) 802.11ac Wireless | STRING | | name | Airport | STRING | 类似这样： [![image.png](https://camo.githubusercontent.com/5e828c5bdf1e70b65080383d1da410e56170b159/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31302f30372f5232386c48674a58474f63774e69332e706e67)](https://camo.githubusercontent.com/5e828c5bdf1e70b65080383d1da410e56170b159/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31302f30372f5232386c48674a58474f63774e69332e706e67) 你也可以将以下内容合并到 `config.plist` 中的 `Devices -> Propertoes` 部分： ``` PciRoot(0x0)/Pci(0x1d,0x6)/Pci(0x0,0x0) AAPL,slot-name WLAN compatible pci14e4,4353 device_type Airport Extreme model DW1820A (BCM4350) 802.11ac Wireless name Airport ``` 要驱动蓝牙，你需要将对应文件夹的 `BrcmPatchRAM2.kext`, `BrcmBluetoothInjector.kext` 和 `BrcmFirmwareData.kext` 放到 kexts/Other 中。 # 屏蔽三星 PM981 NVMe 固态硬盘 ## 这个页面解决什么问题？ 在 macOS 下屏蔽 PM981 硬盘，防止因 PM981 硬盘的存在，引起系统死机等。 ## 注意事项 * 屏蔽 PM981 并不是长久之计，仅适用于迫不得已、不得不保留该硬盘的时候。 * 并不能保证在屏蔽 PM981 硬盘后，就一定不会出现死机等问题。 * 当然，要屏蔽 PM981 硬盘，你需要用另一块兼容 macOS 的 SATA/NVMe 硬盘或机械硬盘来安装系统。 ## 操作 1. **拔除 PM981**，在另一块硬盘上安装好 macOS 系统并确保**能正常进入桌面、不死机**。 2. 下载本仓库下提供的 [SSDT-DNVME.aml](https://github.com/kirainmoe/hasee-tongfang-macos/raw/master/Addons/SSDT-DNVME.aml)，将其放到 `Clover` 配置文件目录的 `ACPI/patched` 下（在该目录下你会看到其它以 `SSDT-` 开头的文件）。 3. 修改 Clover 配置，在 `ACPI => SortedOrder (或译为“分类排序”）` 中添加 `SSDT-DNVME.aml`，如下图所示： ![image.png](https://camo.githubusercontent.com/f0547123b66fe701160fd22346a1f1684e49e293/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32342f334f563846586d5a5139706f6137642e706e67) 你也可以直接使用文本编辑器修改 `config.plist` 添加该 SSDT： ![image.png](https://camo.githubusercontent.com/4771b3e1b64886d66a4558eed7a98cfe24f655d0/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32342f6d5655486a6e726c363738613946772e706e67) 4\. 关机后将 PM981 插到正确被屏蔽的盘位上。如以 KP7GZ、CT7GK 的模具为例，以电池所在位置为下方作参照，KP7GZ/CT7GK 被屏蔽的盘位是偏上的 M.2 位置，将 PM981 插到相应的位置，引导 macOS 看看 PM981 是否被正确屏蔽、引导 Windows 看硬盘是否正常。 5\. 如果没有被正确屏蔽，则将 PM981 换到另一个盘位上测试。 # 更换 4K 屏幕后无法进入系统的解决方案 配置文件默认支持 1080p 的屏幕。如果自行更换了 4K 屏幕，则需要对 `config.plist` 进行相应的修改，否则将会遇到无法进入系统，卡在 **`IOConsoleUsers: gIOScreenLockState 3, hs 0, bs 0 now`** 的错误。 具体修改方式如下： 1. 首先注入 `ig-platform-id` **0x12345678** 进入系统，此时显卡应为未驱动状态。 2. 修改 `config.plist`，在设备设置 `(Devices)` => 属性 `(Properties)` 中，找到 `PciRoot(0x0)/Pci(0x2,0x0)` 一项： ![PciRoot(0x0)/Pci(0x2,0x0)](/files/-LzoVnSGEhH1a3D9Jtij) 3\. 在原有属性的基础上，修改或添加以下属性： | 属性键 (key) | 属性值 (value) | 值类型 (type) | | -------------------------------------- | -------------------------- | ---------- | | AAPL,GfxYTile | 01000000 | DATA | | AAPL,slot-name | Built-in | STRING | | device\_type | Display Controller | STRING | | dpcd-max-link-rate | 14000000 | DATA | | enable-dpcd-max-link-rate-fix | 01000000 | DATA | | enable-hdmi20 | 01000000 | DATA | | enable-lspcon-support | 01000000 | DATA | | framebuffer-con1-alldata | 01050900 00040000 87010000 | DATA | | framebuffer-con2-alldata | 03040A00 00080000 87010000 | DATA | | framebuffer-con2-has-lspcon | 01000000 | DATA | | framebuffer-con2-preferred-lspcon-mode | 01000000 | DATA | | framebuffer-portcount | 04000000 | DATA | | framebuffer-unifiedmem | 000000C0 | DATA | 4\. 删除以下属性： | 属性键 | | ----------------------- | | framebuffer-con0-enable | | framebuffer-con0-pipe | | framebuffer-con1-pipe | | framebuffer-con2-pipe | 完成后，应该像这样： ![](/files/-Lzoc0T1K8VIJEzFWOE3) 5\. 添加引导参数 `-cdfon` . 解决方案来自： # 官方社区安装服务 > 说在前面：鉴于我已经将教程、资源和可能遇到的问题在 wiki 中写得十分完善了，所以我鼓励大家自己探索，享受黑苹果过程的乐趣。 对于本仓库支持的机型，我也提供平价的有偿代装服务。如果你实在是迫不及待想体验黑苹果的话，也可以寻求我的代装帮助。 你可以通过以下途径联系我（请在备注中注明来意）： * QQ: 498855405 * Telegram: @yume\_maruyama * 邮件：