% README.macos 2025-09-16
% Tested on macOS 12.7.2 Monterey VirtualBox (thanks to https://github.com/myspaghetti/macos-virtualbox)

1. Prerequisites for building zint and zint-qt
==============================================

Start a terminal.

First if not already installed, install the developer command line tools

    xcode-select --install

This can take a (very) long time. Once done, check for updates by selecting "System Preferences" > "Software Update",
and clicking "Advanced" and "OK" (with all the checkboxes set) to trigger the check. If updates are found, install.
This can also take a long time.

With the latest versions of the command line tools, "/usr/include" no longer has the standard C include files. Set
SDKROOT to overcome this (https://stackoverflow.com/a/60002595/664741)

    export SDKROOT=$(xcrun --sdk macosx --show-sdk-path)

Install Homebrew (unless already installed)

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

Install CMake, libpng and Qt5 (git, make, cc & c++ should already be available with command line tools)

    brew install cmake
    brew install libpng
    brew install qt5

Clone and install the gs1encoders library (optional but necessary for GS1 Syntax Engine support):

    git clone https://github.com/gs1/gs1-syntax-engine
    cd gs1-syntax-engine/src/c-lib
    make CFLAGS_G='-DEXCLUDE_SYNTAX_DICTIONARY_LOADER' lib && sudo make install
    cd ../../..

Add the Qt5 bin directory to the PATH

    export PATH='/usr/local/opt/qt@5/bin':"$PATH"

Clone the latest zint source

    git clone https://git.code.sf.net/p/zint/code zint


2. Build
========

The rest is standard CMake

   cd zint
   mkdir build
   cd build
   cmake ..
   make
   sudo make install

This installs into "/usr/local". You can then move the GUI "/usr/local/bin/zint-qt.app" into the main "/Applications"
folder if you wish.


3. CMake options
================

See "README.linux".