From 24cd690c1cd4f325a8f7ecdb5ae78711aa0a3fcd Mon Sep 17 00:00:00 2001 From: Bruce Forstall Date: Thu, 16 Jan 2020 14:29:02 -0800 Subject: [PATCH] Update macOS build requirements to include openssl --- .../requirements/macos-requirements.md | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/workflow/requirements/macos-requirements.md b/docs/workflow/requirements/macos-requirements.md index 20f8bfe04ac..4a400c41220 100644 --- a/docs/workflow/requirements/macos-requirements.md +++ b/docs/workflow/requirements/macos-requirements.md @@ -33,3 +33,36 @@ ICU (International Components for Unicode) is also required to build and run. It brew install icu4c brew link --force icu4c ``` + +OpenSSL +------- + +To build the libraries on macOS, you must install and configure links for OpenSSL 1.1, and install `pkg-config` to use it. Using [Homebrew](http://brew.sh/): + +```sh +brew install pkg-config 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/`, 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/ +```