agrarian/depends

Usage

To build dependencies for the current arch+OS:

make HOST=x86_64-pc-linux-gnu NO_QT=0

To build for another arch/OS:

make HOST=host-platform-triplet

For example:

make HOST=x86_64-w64-mingw32 NO_QT=0 -j1

A prefix will be generated that's suitable for plugging into Agrarian's configure. In the above example, a dir named x86_64-w64-mingw32 will be created. To use it for Agrarian:

CONFIG_SITE=`pwd`/depends/x86_64-w64-mingw32/share/config.site ./configure --prefix=/

Common host-platform-triplets for cross compilation are:

• i686-w64-mingw32 for Win32
• x86_64-w64-mingw32 for Win64
• x86_64-apple-darwin14 for macOS
• arm-linux-gnueabihf for Linux ARM 32 bit
• aarch64-linux-gnu for Linux ARM 64 bit
• riscv32-linux-gnu for Linux RISC-V 32 bit
• riscv64-linux-gnu for Linux RISC-V 64 bit

No other options are needed, the paths are automatically configured.

For the current Agrarian 2.0 branch, the preferred user-facing build entry points are the helpers in contrib/:

• contrib/build-linux.sh
• contrib/build-linux-wallet.sh
• contrib/build-win64-wallet.sh
• contrib/agrarian-build-menu.sh

Those helpers set the correct Qt and host-tool paths around the depends prefix.

Install the required dependencies: Ubuntu & Debian

For macOS cross compilation

sudo apt-get install curl librsvg2-bin libtiff-tools bsdmainutils cmake imagemagick libcap-dev libz-dev libbz2-dev python3-setuptools

For Win32/Win64 cross compilation

• see build-windows.md

For linux (including i386, ARM) cross compilation

Common linux dependencies:

sudo apt-get install make automake cmake curl git g++-multilib libtool binutils-gold bsdmainutils pkg-config python3 patch bzip2 xz-utils

Native Linux Qt wallet builds also need the desktop development headers used by Qt's xcb/font stack:

sudo apt-get install libfontconfig1-dev libfreetype-dev libharfbuzz-dev \
  libbrotli-dev libbz2-dev libexpat1-dev libglib2.0-dev \
  libgraphite2-dev libpng-dev zlib1g-dev libx11-xcb-dev \
  libxcb1-dev libxcb-cursor-dev libxcb-icccm4-dev libxcb-image0-dev \
  libxcb-keysyms1-dev libxcb-randr0-dev libxcb-render0-dev \
  libxcb-render-util0-dev libxcb-shape0-dev libxcb-shm0-dev \
  libxcb-sync-dev libxcb-util-dev libxcb-xfixes0-dev \
  libxcb-xinerama0-dev libxcb-xkb-dev libxau-dev libxdmcp-dev \
  libxext-dev libxi-dev libxrender-dev libxkbcommon-dev \
  libxkbcommon-x11-dev

For linux ARM cross compilation:

sudo apt-get install g++-arm-linux-gnueabihf binutils-arm-linux-gnueabihf

For linux AARCH64 cross compilation:

sudo apt-get install g++-aarch64-linux-gnu binutils-aarch64-linux-gnu

For linux RISC-V 64-bit cross compilation (there are no packages for 32-bit):

sudo apt-get install g++-riscv64-linux-gnu binutils-riscv64-linux-gnu

RISC-V known issue: gcc-7.3.0 and gcc-7.3.1 result in a broken test_agrarian executable (see https://github.com/bitcoin/bitcoin/pull/13543), this is apparently fixed in gcc-8.1.0.

Dependency Options

The following can be set when running make: make FOO=bar

SOURCES_PATH: downloaded sources will be placed here
BASE_CACHE: built packages will be placed here
SDK_PATH: Path where sdk's can be found (used by macOS)
FALLBACK_DOWNLOAD_PATH: If a source file can't be fetched, try here before giving up
NO_QT: Don't download/build/cache qt and its dependencies
USE_ZMQ: Build and cache ZeroMQ for optional ZMQ notification support
NO_WALLET: Don't download/build/cache libs needed to enable the wallet
NO_UPNP: Don't download/build/cache packages needed for enabling upnp
DEBUG: disable some optimizations and enable more runtime checking
HOST_ID_SALT: Optional salt to use when generating host package ids
BUILD_ID_SALT: Optional salt to use when generating build package ids

If some packages are not built, for example make NO_WALLET=1, the appropriate options will be passed to Agrarian's configure. In this case, --disable-wallet.

Additional targets

download: run 'make download' to fetch all sources without building them
download-osx: run 'make download-osx' to fetch all sources needed for macOS builds
download-win: run 'make download-win' to fetch all sources needed for win builds
download-linux: run 'make download-linux' to fetch all sources needed for linux builds

Other documentation

• description.md: General description of the depends system
• packages.md: Steps for adding packages