Skip to content

Latest commit

 

History

History
69 lines (50 loc) · 2.07 KB

macos-requirements.md

File metadata and controls

69 lines (50 loc) · 2.07 KB
Raw

Requirements to build dotnet/runtime on macOS

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.

Environment

These instructions were validated on macOS 10.15 (Catalina).

Xcode

Install Apple Xcode developer tools from the Mac App Store (link).

Toolchain Setup

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.15.5 or newer
  • autoconf
  • automake
  • libtool
  • pkg-config
  • python3
  • icu4c

The lines to install all the packages above using Homebrew.

brew install cmake autoconf automake libtool pkg-config python3 icu4c
brew link --force icu4c

OpenSSL

To build the libraries on macOS, you must install and configure links for OpenSSL 1.1.

brew install openssl

# You might need to "link" pkg-config:
brew link pkg-config

# We need to make the runtime libraries discoverable, as well as make
# pkg-config be able to find the headers and current ABI version.
#
# Ensure the paths we will need exist
mkdir -p /usr/local/lib/pkgconfig

# The rest of these instructions assume a default Homebrew path of
# `/usr/local/opt/<module>`, with `brew --prefix` returning `/usr/local`
# and `brew --prefix openssl` returning `/usr/local/opt/openssl@1.1`.
# In this case, `brew info openssl` shows:
# `openssl@1.1: stable 1.1.1d (bottled) [keg-only]`.

# Runtime dependencies
ln -s /usr/local/opt/openssl\@1.1/lib/libcrypto.1.1.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl\@1.1/lib/libssl.1.1.dylib /usr/local/lib/

# Compile-time dependencies (for pkg-config)
ln -s /usr/local/opt/openssl\@1.1/lib/pkgconfig/libcrypto.pc /usr/local/lib/pkgconfig/
ln -s /usr/local/opt/openssl\@1.1/lib/pkgconfig/libssl.pc /usr/local/lib/pkgconfig/
ln -s /usr/local/opt/openssl\@1.1/lib/pkgconfig/openssl.pc /usr/local/lib/pkgconfig/