third_party/jpeg-xl/BUILDING_OSX.md

   1 ## Disclaimer
   2
   3 OSX builds have "best effort" support, i.e. build might not work at all, some
   4 tests may fail and some sub-projects are excluded from build.
   5
   6 This manual outlines OSX specific setup. For general building and testing
   7 instructions see "[BUILDING](BUILDING.md)" and
   8 "[Building and Testing changes](doc/building_and_testing.md)".
   9
  10 [Homebrew](https://brew.sh/) is a popular package manager. JPEG XL library and
  11 binaries could be installed using it:
  12
  13 ```bash
  14 brew install jpeg-xl
  15 ```
  16
  17 ## Dependencies
  18
  19 Make sure that `brew doctor` does not report serious problems and up-to-date
  20 version of XCode is installed.
  21
  22 Installing (actually, building) `clang` might take a couple hours.
  23
  24 ```bash
  25 brew install llvm
  26 ```
  27
  28 ```bash
  29 brew install coreutils cmake giflib jpeg-turbo libpng ninja zlib
  30 ```
  31
  32 Before building the project check that `which clang` is
  33 `/usr/local/opt/llvm/bin/clang`, not the one provided by XCode. If not, update
  34 `PATH` environment variable.
  35
  36 Also, setting `CMAKE_PREFIX_PATH` might be necessary for correct include paths
  37 resolving, e.g.:
  38
  39 ```bash
  40 export CMAKE_PREFIX_PATH=`brew --prefix giflib`:`brew --prefix jpeg-turbo`:`brew --prefix libpng`:`brew --prefix zlib`
  41 ```