mirror of
https://github.com/RGBCube/serenity
synced 2025-10-31 15:52:43 +00:00
4b85866746
This should prevent a build issue caused by a potential conflicting zstd installation on M1 Mac. This was manifested in a linker error when building the GNU toolchain: ``` Undefined symbols for architecture arm64: [gcc/build] "_ZSTD_compress", referenced from: ```
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# Setting up a development environment on macOS
|
|
|
|
# Prerequisites
|
|
|
|
This installation guide assumes that you have [Homebrew](https://brew.sh) and Xcode installed. You need to open Xcode at least once for it to install the required tools.
|
|
|
|
Before you build, you must set your command line tools to Xcode's tools instead of the ones installed via Homebrew:
|
|
```console
|
|
sudo xcode-select --switch /Applications/Xcode.app
|
|
```
|
|
|
|
Make sure you also have all the following dependencies installed:
|
|
|
|
```console
|
|
# core
|
|
brew install coreutils e2fsprogs qemu bash gcc@11 imagemagick ninja cmake ccache rsync zstd
|
|
|
|
# (option 1) fuse + ext2
|
|
brew install m4 autoconf automake libtool
|
|
brew install --cask macfuse
|
|
Toolchain/BuildFuseExt2.sh
|
|
|
|
# (option 2) genext2fs
|
|
brew install genext2fs
|
|
```
|
|
|
|
If you're building on M1 Mac and have Homebrew installed in both Rosetta and native environments,
|
|
you have to make sure that required packages are installed only in one of the environments. Otherwise,
|
|
these installations can conflict during the build process, which is manifested in hard to diagnose issues.
|
|
Building on M1 natively without Rosetta is recommended, as the build process should be faster without Rosetta
|
|
overhead.
|
|
|
|
Notes:
|
|
|
|
- Installing macfuse for the first time requires enabling its system extension in System Preferences and then restarting
|
|
your machine. The output from installing macfuse with brew says this, but it's easy to miss.
|