Build Instructions for macOS

Notice: Be aware that there is no official support for macOS. You can still try to build Zeal manually, but that is not guaranteed to work.

Please avoid reporting issues you encounter on macOS, unless they are also reproducible on Linux or Windows.

Installing dependencies

Use one of the following methods, based on which package manager you use.

Homebrew

brew install [email protected] libarchive

You may choose to link qt, as the brew formula is 'keg-only', which avoids writing the full path to the qmake executable below. You may do so by:

brew link [email protected] --force

MacPorts

port install qt5 qt5-qtwebengine qt5-sqlite-plugin libarchive

Building Zeal

Source code

To test the most recent version of source code, fetch it from GitHub:

git clone https://github.com/zealdocs/zeal.git

Compiling

Homebrew

Replace the full path to qmake with just the name of the command, if you linked qt as described above.

/usr/local/Cellar/[email protected]/5.5.1_1/bin/qmake INCLUDEPATH+=/usr/local/opt/libarchive/include
make SUBLIBS="-L/usr/local/opt/libarchive/lib -larchive -lsqlite3"

MacPorts

/opt/local/libexec/qt5/bin/qmake INCLUDEPATH+=/opt/local/include
make SUBLIBS="-L/opt/local/lib -larchive -lsqlite3"

Appbundle

Create an application bundle:

cd bin
/opt/local/libexec/qt5/bin/macdeployqt Zeal.app

Homebrew

Create an application bundle:

Replace the full path to macdeployqt with just the name of the command, if you linked qt as described above.

cd bin
/usr/local/Cellar/[email protected]/5.5.1_1/bin/macdeployqt Zeal.app

Installation

Simply move Zeal.app to your Applications directory.