# 黑苹果安装学院
[![License](https://img.shields.io/badge/license-CC%204.0-blue.svg)](https://creativecommons.org/licenses/by/4.0/)
![progress](https://img.shields.io/badge/progress-developing-yellow.svg)
[![contributions](https://img.shields.io/badge/contributions-welcome-green.svg)](https://github.com/huangyz0918/Hackintosh-Installer-University) 

:loudspeaker: 这是一个开源的黑苹果教程仓库,对所有用户免费。 

:loudspeaker: 我们都知道, 黑苹果其实是一个具有潜在盗版性质的行为,因为它违反了苹果公司的 EULA 法案[(EULA)](http://images.apple.com/legal/sla/docs/macosx107.pdf)。 所以我们这个 Github 仓库只是以安装黑苹果为一个引线,进而介绍和分享关于苹果操作系统的相关知识和系统的一些安装方法,不参与任何商业活动,也不允许任何人使用我们搜集和创作的资料参与任何商业活动。如果你想要开始黑苹果技术,我们希望你是抱着一个极客的心态来的,并且将这些技术应用到其他相关领域的学习和工作中去。

这里是其他语言的版本:
- [English version](README.md)


## 什么是黑苹果呢?

> 自从苹果采用 Intel 的处理器,OS X 被黑客破解后可以安装在 Intel CPU 与部分 AMD CPU 的机器上。从而出现了一大批非苹果设备而使用苹果操作系统的机器,被称为黑苹果(Hackintosh);在 Mac 苹果机上面安装原版 Mac 系统的被称为白苹果(Macintosh),与黑苹果相对。

## 如何学习黑苹果 ?

:bell: 如果你想要一步步从底层理解黑苹果的原理和计算机操作系统的相关知识, 请走这扇门 ---> [:door:](slow/slow-cn.md)

:bell: 如果你对黑苹果背后的原理和一些细节,只想快速完成黑苹果的安装,请走这扇门 ---> [:door:](quick/quick-cn.md)

### 一些关于黑苹果和 macOS 的参考网站
- [Wikipedia](https://en.wikipedia.org/wiki/Hackintosh)
- [OSx86 Project](https://www.osx86project.org/)
- [Tonymacx86](https://www.tonymacx86.com/)
- [hackintosh.com](https://hackintosh.com/)
- [9to5mac](https://9to5mac.com/)
- [Rehabman Github](https://github.com/RehabMan)
- [Rehabman Bitbucket](https://bitbucket.org/RehabMan/)
- [PCbeta](http://mac.pcbeta.com/)
- [iMacHK](https://imac.hk/)

### Github 上一些贡献者的配置

- [Acer Aspire E1-471G](https://github.com/matthew728960/Clover-ACER-E1-471G)
- [Acer A515-51G](https://github.com/SiddheshNan/Acer-A515-51G-Hackintosh)
- [Acer V5-573G](https://github.com/Kaijun/Acer-V5-573G-Hackintosh)
- [Acer Aspire E5-571-376T](https://github.com/GalaticStryder/Acer-E5-571-Hackintosh)
- [Acer Aspire V3-371-52FF](https://github.com/Ty3uK/52ff-elcapitan-toolbox)
- [Acer Aspire E5-473-30N5](https://github.com/b-ggs/aspire-e5-hackintosh)
- [Acer Aspire V3-572G](https://github.com/FREDwiz/Hackintosh)
- [Alienware 17 R4 KBL-1060 Dual Graphics](https://github.com/RockJesus/Alienware-17-R4-I7-7700HQ-MacOS-High-Sierra)
- [Asus FX50J/X550JX](https://github.com/Xc2333/Hackintosh-ASUS-FX50J)
- [Asus H81M-K](https://github.com/Slbomber/AsusH81MK-macos)
- [Asus Zenbook](https://github.com/hieplpvip/ASUS-ZENBOOK-HACKINTOSH)
- [Asus Vivobook S510UA](https://github.com/tctien342/Asus-Vivobook-S510UA-High-Sierra-10.13-Hackintosh)
- [Asus ROG Zephyrus S GX531](https://github.com/williambj1/Hackintosh-EFI-Asus-Zephyrus-S-GX531)
- [Dell 7559 4K SKL](https://github.com/RockJesus/Dell-7559-I7-6700HQ-4K-touch-MacOS-High-Sierra)
- [Dell G7 7588 OpenCore](https://github.com/Juan-VC/Hackintosh-macOS-Dell-G7-7588)
- [Dell XPS13-9350-Skylake](https://github.com/syscl/XPS9350-macOS)
- [Dell XPS15-9550](https://github.com/corenel/XPS9550-macOS)
- [Dell XPS15-9550](https://github.com/PromiseYo/XPS15-9550-macOS)
- [Dell XPS13-9360](https://github.com/the-darkvoid/XPS9360-macOS)
- [Dell XPS15-9530-Haswell](https://github.com/the-darkvoid/XPS9530-OSX)
- [Gigabyte GA-Z77-DS3H](https://github.com/tkrotoff/Gigabyte-GA-Z77-DS3H-rev1.1-Hackintosh)
- [Gigabyte GA-H97-D3H](https://github.com/korzhyk/Clover_GA-H97-D3H)
- [Gigabyte GA-Z270M-D3H](https://github.com/LER0ever/Hackintosh)
- [Gigabyte X99P-SLI](https://github.com/koush/EFI-X99)
- [Gigabyte Aero15-W](https://github.com/Errrneist/Hackintosh-Aero-15W)
- [Gigabyte z170x ud3 ultra](https://github.com/RoJoHub/Hackintosh)
- [Gigabyte Sabre15K](https://github.com/gnehs/Sabre15KClover)
- [Lenovo chao 5000](https://github.com/Xc2333/Hackintosh-Lenovo-chao5000)
- [Lenovo G50-70M](https://github.com/LEXUGE/macOS-Lenovo_G50-70M)
- [Lenovo G50-80](https://github.com/upupming/Lenovo-G50-80-Clover)
- [Lenovo Thinkpad P50](https://github.com/Errrneist/Hackintosh-Thinkpad-P50)
- [Lenove Thinkpad T450](https://github.com/shmilee/T450-Hackintosh)
- [Lenovo Thinkpad T460P](https://github.com/LER0ever/Hackintosh)
- [Lenovo T430s](https://github.com/dmitriypavlov/T430s-macOS)
- [Lenovo T430-NVS5400M](https://github.com/david-cako/T430-Hackintosh)
- [Lenovo T450s](https://github.com/stevenmirabito/T450s-Hackintosh)
- [Lenovo U330/U430/U530](https://github.com/RehabMan/Lenovo-U430-Touch-DSDT-Patch)
- [Lenovo Y470](https://github.com/Dwarven/Hackintosh/tree/master/Lenovo%20Y470)
- [Lenovo Y50-70](https://github.com/RehabMan/Lenovo-Y50-DSDT-Patch)
- [Lenovo Z50-70](https://github.com/Maxvien/hackintosh-lenovo-z5070)
- [Lenovo B470](https://github.com/0xE8551CCB/hackintosh)
- [Lenovo G470](https://github.com/hunterMG/DSDT-Lenovo-G470)
- [Lenovo T470 (i5-6300U)](https://github.com/okay/t470)
- [Lenovo x230 ](https://github.com/edu-rinaldi/Lenovo-x230-High-Sierra)
- [Lenovo Yoga 710](https://github.com/xiaoxx970/Hackintosh-Mojave-for-Lenovo-Yoga710)
- [Lenovo Yoga 3 Pro](https://github.com/zohaad/hackintosh-Yoga-3-Pro)
- [Lenovo-v3000-ISE](https://github.com/Xc2333/Hackintosh-Lenovo-v3000-ISE)
- [Lenovo-rescuer-15-isk](https://github.com/oneplusdash/lenovo-rescuer-15-isk-hackintosh)
- [Lenovo Ideapad 310-14IKB](https://github.com/29satnam/LenovoHackintoshEFI)
- [Lenovo-XiaoXin700-15ISK](https://github.com/athlonreg/Lenovo-XiaoXin700-15ISK)
- [HUANAN X79](https://github.com/cheneyveron/clover-x79-e5-2670-gtx650)
- [HP ProBook/EliteBook/ZBook](https://github.com/RehabMan/HP-ProBook-4x30s-DSDT-Patch)
- [HP Elitebook 8470p](https://github.com/minhphuc429/hackintosh-hp-elitebook-8470p)
- [HP Elitebook 8470p](https://github.com/dreadkopp/8470p_10.13.x)
- [HP Elitebook 840 G1/G2](https://github.com/loicpirez/HackintoshConfig)
- [HP Elitebook Folio 9480m](https://github.com/obviouslyerratic/clover_9480m)
- [HP EliteDesk 800 G2 TWR](https://github.com/sakoula/HP-EliteDesk-800-G2-6700)
- [HP Envy J-series](https://github.com/RehabMan/HP-Envy-DSDT-Patch)
- [HP Envy K-series](https://github.com/RehabMan/HP-Envy-K-DSDT-Patch)
- [HP Envy Q-series](https://github.com/RehabMan/HP-Envy-Q-DSDT-Patch)
- [HP Envy N-series](https://github.com/RehabMan/HP-Envy-N-DSDT-Patch)
- [HP Z420 Workstation](https://github.com/NTT123/Hackintosh-HP-Z420-MacOS-High-Sierra-10.13)
- [Samsung 450r5j](https://github.com/LER0ever/Hackintosh)
- [Samsung nt550p7c-IVY](https://github.com/RockJesus/samsung-nt550p7c-sierra)
- [Samsung NT900X3L-K501S](https://github.com/justiceserv/NT900X3L-Hackintosh)
- [XiaoMi NoteBook Pro](https://github.com/daliansky/XiaoMi-Pro)
- [Xiaomi Mi Air 13.3 Skylake-U 2016 (1rst Gen)](https://github.com/sakoula/XiaoMi-Air-6200U)

### 本 Repo 现有设备配置

- [Lenove B50-70](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Res/%20Lenove-B50-intelHD4600-success)
- [Asus-P8Z77-V-LX-10.12.6](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Res/Asus-P8Z77-V-LX-10.12.6)
- [Gigabyte Z270XP-SLI](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Res/Gigabyte-GA-Z270XP-SLI-10.13.4)



## 一些现有的 CLOVER EFI 收集

- [Asus](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Asus)
- [Acer](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Acer)
- [Lenovo](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Lenovo)
- [Dell](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Dell)
- [Xiao Mi](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/XiaoMi)
- [LG](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/LG)


## 我要怎样才能为这个 Repo 做出贡献?

你需要先 `Fork` 这个仓库, 只要点击本页面上方的 `Fork` 按钮即可。
在你 `Fork` 这个项目之前,你需要将这个仓库克隆到本地并且在你自己的分支上进行修改和添加内容。我们对广大参与贡献的朋友表示衷心的感谢!

### **为教程仓库做贡献**
教程是我们这个项目的核心部分,我们将教程分为以下几个部分:

- **购买者指导**

   在这一个部分,你将会了解到什么样的硬件适合安装一个黑苹果,并且在这个过程中你可以学习到很多计算机硬件的特性,例如 CPU、存储器和显卡等。 我们使用一个单独的文件夹 `Hardwares` 来放置这些相关的教程。

- **引导安装指导**

   这部分我们将专注于黑苹果引导的配置和安装,如果你感兴趣,你可以了解到关于计算机启动和引导的一些知识,甚至还可以帮助编译同样是开源项目的一些计算机引导系统。 另外我们会在这部分分享有关四叶草引导和变色龙引导的有关知识,并且我们希望听到你的见解和经验! 我们使用 `Bootloader` 文件夹来保存这些资料。

- **系统安装指导**
  
   这部分着重介绍关于黑苹果系统安装的操作,`System` 文件夹用来放置这些资料。在完成这部分的时候,你将完成一个系统的基础安装,但是这是不带驱动和补丁的,你还需要进一步完美你的机器。

- **驱动安装**

   这部分重点在于介绍黑苹果各个驱动的安装,在这部分你会接触到各种补丁和 macOS 的驱动文件,所以做好准备。如果你有宝贵的经验,别忘了把它们放到 `Post` 目录下并且提交 Pull Request。

- **问题分析**

   这部分是用来讨论所谓的“玄学”的,因为黑苹果很大一部分成功是来自于安装的经验,不过我相信成功和失败背后总是有原因的,所以我创建了 `troubleshooting` 这个文件夹,大家可以把自己遇到的一些棘手的问题以及解决方法 `Post` 在这个目录下供自己备份,也供后来人阅读和共享.

最后,我们是一群热爱黑客技术和折腾的极客,为了信仰在这里维护一个学习和交流的平台,希望能在这里遇到更多的贡献者和开发者!

### **为资源做贡献**
我们鼓励贡献者上传自己成功的配置文件和驱动到这个仓库,但是在贡献之前,请查看上传的贡献规则:

- 在 `Res` 文件夹下面创建属于自己机器的黑苹果文件夹,命名规则: `厂家-型号-系统版本`。
- 如果有引导的配置文件,请在根目录下放置。 并且 创建一个子文件夹:`kexts` 用来放置你的驱动文件。
- 此 Repo 不适合上传巨大的文件(如:安装镜像),体积较大的文件请使用链接的形式给出。
- `kexts`文件夹下面可以根据不同的驱动种类创建不同的文件夹,如果你想直接把整个 EFI 文件夹,也是好的。
- 最后别忘了给出你的电脑配置说明文件,请在你的目录下建立一个名叫:`info.md` 的 Markdown 说明文件。

这里有一个例子:

```bash

Res/
└── Lenove-B50-10.12.6
    ├── config.plist
    ├── info.md
    └── kexts/

```

一个不错的 `info.md` 例子:

```markdown
- Device name: GA-Z170-Gaming 7
- CPU: i7-6700K
- Graphics: Nvidia GeForce GT 640
- Graphics: Intel HD4600

```
我们期待你的贡献! :+1:

## 证书
[Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/)

<img width="120" src="https://i.loli.net/2018/05/15/5afaddc9aa3f5.png"/><img width="120" src="https://i.loli.net/2018/05/15/5afaddc9a9789.png"/>