mirror of
https://github.com/RGBCube/serenity
synced 2025-07-27 04:37:34 +00:00
Documentation: Reorganize the build documentation
This commit is contained in:
parent
9780cdfb33
commit
9026dbbfd6
13 changed files with 419 additions and 389 deletions
51
Documentation/BuildInstructionsMacOS.md
Normal file
51
Documentation/BuildInstructionsMacOS.md
Normal file
|
@ -0,0 +1,51 @@
|
|||
# Setting up a development environment on macOS
|
||||
|
||||
# Prerequisites
|
||||
|
||||
This installation guide assumes that you have Homebrew, Xcode and `xcode-tools` installed.
|
||||
|
||||
Make sure you also have all the following dependencies installed:
|
||||
|
||||
```console
|
||||
# core
|
||||
brew install coreutils qemu bash gcc@10 ninja cmake ccache rsync
|
||||
|
||||
# (option 1) fuse + ext2
|
||||
brew install e2fsprogs m4 autoconf automake libtool
|
||||
brew install --cask osxfuse
|
||||
Toolchain/BuildFuseExt2.sh
|
||||
|
||||
# (option 2) genext2fs
|
||||
brew install genext2fs
|
||||
```
|
||||
|
||||
Notes:
|
||||
|
||||
- Installing osxfuse for the first time requires enabling its system extension in System Preferences and then restarting
|
||||
your machine. The output from installing osxfuse with brew says this, but it's easy to miss.
|
||||
|
||||
## Hardware acceleration on macOS Big Sur
|
||||
|
||||
If you are on macOS Big Sur, you will need to manually enable QEMU's hardware acceleration before running Serenity, by
|
||||
creating a new file called `entitlements.xml` in the `Build/` folder, with the content below, and then running this
|
||||
command:
|
||||
|
||||
`codesign -s - --entitlements entitlements.xml --force /usr/local/bin/qemu-system-x86_64`
|
||||
|
||||
<details>
|
||||
<summary>Content for 'entitlements.xml'.</summary>
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
|
||||
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>com.apple.security.hypervisor</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</plist>
|
||||
```
|
||||
|
||||
</details>
|
||||
|
Loading…
Add table
Add a link
Reference in a new issue