diff --git a/Documentation/MacDevelopment.md b/Documentation/MacDevelopment.md index 8aed34b2f..404218e69 100644 --- a/Documentation/MacDevelopment.md +++ b/Documentation/MacDevelopment.md @@ -11,11 +11,19 @@ git clone --recursive https://github.com/utmapp/UTM.git Alternatively, run `git submodule update --init --recursive` after cloning if you did not do a recursive clone. -## Dependencies +## Downloading PreBuilt SysRoot Dependencies -The easy way is to get the prebuilt dependences from [GitHub Actions][1]. Pick the latest release and download all of the `Sysroot-macos-*` artifacts. You need to be logged in to GitHub to download artifacts. If you only intend to run locally, it is alright to just download the sysroot for your architecture. +The easiest way is to get the prebuilt dependences from Github. -### Building Dependencies (Advanced) +- Find the list of [release builds here][1]. +- Pick the latest release and download all of the `Sysroot-macos-*` artifacts for the architecture you will need (you will need to be signed in to a github account). If you only intend to run locally, it is alright to just download the sysroot for your traget architecture. +- Unpack them into the UTM project folder. You should have a "folder" configured per architecture (see screenshot for an example) + +![Example of prebuilt sysroot](./imgs/prebuilt-sysroot.png) + +### Building SysRoot Dependencies (Advanced) + +| This is optional, and is only necessary if you changed stuff with Qemu or the patches. If you want to build the dependencies yourself, it is highly recommended that you start with a fresh macOS VM. This is because some of the dependencies attempt to use `/usr/local/lib` even though the architecture does not match. Certain installed packages like `libusb`, `gawk`, and `cmake` will break the build. diff --git a/Documentation/imgs/prebuilt-sysroot.png b/Documentation/imgs/prebuilt-sysroot.png new file mode 100644 index 000000000..dee1a6edf Binary files /dev/null and b/Documentation/imgs/prebuilt-sysroot.png differ