This guide will walk you through the requirements needed to build dotnet/runtime on macOS. We'll start by showing how to set up your environment from scratch.
Here are the components you will need to install and setup to work with the repo.
- Install Apple Xcode developer tools from the Mac App Store.
- Configure the Xcode command line tools:
- Run Xcode, open Preferences, and on the Locations tab, change "Command Line Tools" to point to this installation of Xcode.app. This usually comes already done by default, but it's always good to ensure.
- Alternately, you can run
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
in a terminal (Adjust the path if you renamed Xcode.app).
Building dotnet/runtime depends on several tools to be installed. You can download them individually or use Homebrew for easier toolchain setup.
Install the following packages:
- CMake 3.20 or newer
- icu4c
- openssl@1.1 or openssl@3
- pkg-config
- python3
- ninja (optional, enables building native code with ninja instead of make)
You can install all the required packages above using Homebrew by running this command in the repository root:
brew bundle --no-lock --file eng/Brewfile