欢迎

概览

这个项目旨在让你的搭载了第 8 代、第 9 代 Intel CPU 、采用了清华同方模具的神舟笔记本,能够尽可能完美地安装上最新版本的 macOS 操作系统(俗称“黑苹果”)。

如何使用 hasee-tongfang-macos 仓库下的配置文件?

还没装好系统?

  • 请按照 安装教学视频 里的指引安装好系统,并替换配置文件即可。

  • 替换配置文件后,请按照此视频指导,使用 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 下载对应机型的最新版本配置文件,然后按照《EFI 替换教程》 替换。

若想要使用 OpenCore 引导

可以前往对应机型带有 -opencore 后缀的分支,在 GitHub 页面点击 "Clone or Download" => "Download Zip" 下载最新版本。

导航

请善于使用右上角的搜索框,搜索问题的关键字。

兼容性情况

兼容的型号

不兼容的型号

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

对于上述机型,可以到百度、远景或此仓库尝试找到对应模具/机型的 EFI.

兼容的 macOS 版本

注意:因为维护者不再测试旧版系统,故未来的配置文件可能随时停止对 macOS 10.14 (Mojave) 和 macOS 10.13 (High Sierra) 版本系统的支持。

当前版本配置文件的系统支持表如下:

✅ yes:当前版本的配置文件在该系统版本下测试通过,各种功能符合预期 🔒 deprecated: 配置文件曾经兼容此版本系统,但现阶段无人测试;且未来可能不再兼容该版本 ❓untest:没有用户或开发者在此设备上测试 ❌no:配置文件不兼容此版本

设备驱动情况

以下为维护者个人电脑的配置详情,以及对比原机的配置。

正常工作的功能

  • 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 外置通道,没有兼容驱动)

获取社区帮助

请确保你在群里问问题之前,已经看过了教学视频、并使用了搜索功能查找并仔细阅读了项目文档内的相关内容!

我们要求你具有基本的知识,如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS,但多数情况我们只能帮你点睛。如果没有上述基技能,建议先前往远景论坛或国外黑苹果论坛爬帖。

许可协议 & 捐赠

Maruyama License 协议 的许可下,使用本仓库下的所有配置文件都是免费的。如果有人向你售卖配置文件,请立刻要求他退款。

希望你们也能够发扬开源和分享精神,积极提出建议和想法、Pull Request,由大家共同打造完美的黑果体验。

当然,如果您认可我的工作,也可以通过捐赠支持我。所有的捐赠将会成为我更新的动力。

Last updated