Instructions on how to set up the DALi environment on macOS.

Dependencies

Homebrew

Refer to the homebrew website for the macOS requirements for Homebrew.

To install Homebrew, run the following command:

% /bin/zsh -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

From homebrew install:

autoconf
automake
cmake
gettext
libtool
pkg-config

% brew install autoconf automake cmake gettext libtool pkg-config

Vcpkg

Refer to the vcpkg website for the prerequisites for macOS for vcpkg.

It is recommended that the commit listed below is obtained as this has been tested:

% git clone https://github.com/microsoft/vcpkg
% cd vcpkg
% git reset --hard 9ddc9173d7858ddb40b2fc0cdc73b529c390ba47

At the time of writing, there are certain issues with angle¹, fontconfig² & glib³ in vcpkg. To fix these run:

% ln -sf /Library/Fonts/ ~/.fonts
% cd /path/to/vcpkg
% for patch in /path/to/macos-dependencies/*.patch; do patch -p1 -l -i $patch; done

To set up vcpkg, run the following command:

% /path/to/vcpkg/bootstrap-vcpkg.sh

And through vcpkg install:

angle
bzip2
cairo
curl
dirent
egl-registry
expat
fontconfig
fribidi
getopt
gettext
giflib
glib
harfbuzz
libexif
libffi
libiconv
libjpeg-turbo
libpng
libwebp
opengl
pcre
pixman
pthreads
ragel
tool-meson
zlib

% ./vcpkg install angle bzip2 cairo curl dirent egl-registry expat fontconfig fribidi getopt gettext giflib glib harfbuzz libexif libffi libiconv libjpeg-turbo libpng libwebp opengl pcre pixman pthreads ragel tool-meson zlib

¹: DALi requires a more recent version of the angle library to render.

²: Fontconfig does not parse the system fonts so the easiest thing to do is to just create a symbolic link in your home directory as shown. Additionally, FONTCONFIG_FILE needs to be set but that's done when we generate the setenv (see later).

³: A reported bug where glib does not build out of the box on macOS.

DALi Environment Setup

Now you need to create a dali-env folder and then set some environment variables. First of all:

VCPKG_FOLDER should contain the absolute path to your vcpkg installation
DESKTOP_PREFIX should contain the absolute path to dali-env

% export VCPKG_FOLDER="${HOME}/path/to/vcpkg"
% export DESKTOP_PREFIX="${HOME}/path/to/dail-env"

These, along with many other environment variables, need to be set every time a new terminal is opened. The script create-setenv can be used to create a setenv file using the VCPKG_FOLDER and DESKTOP_PREFIX defines:

% /path/to/macos-dependencies/create-setenv > /path/to/setenv
% /path/to/macos-dependencies/create-setenv --debug > /path/to/setenv-debug # Optional, for debugging purposes

Now when you open a new terminal you can simply source your setenv file:

% source /path/to/setenv

Once this is done, you are ready to build the DALi repos as specified in each repo's README.md files.

dalihub/macos-dependencies

Table of Contents

Dependencies

Homebrew

Vcpkg

DALi Environment Setup