libzmq/builds/android/README.md

Android Build

Prerequisites

The last known NDK is automatically downloaded, if not specified otherwise.

Configuration

Basics

Basically, LIBZMQ build for Android, relies on exported variables.

Provided build scripts can mainly be used like

export XXX=xxx
export YYY=yyy
...
cd <libzmq>/builds/android
./<build_script>

Android NDK

LIBZMQ is tested against Android NDK version r25, but should support older ones too.

By default, LIBZMQ uses NDK android-ndk-r25, but you can specify a different one:

export NDK_VERSION=android-ndk-r23c

If you already have installed your favorite NDK somewhere, all you have to do is to export and set NDK_VERSION and ANDROID_NDK_ROOT environment variables, e.g:

export NDK_VERSION="android-ndk-r23b"
export ANDROID_NDK_ROOT=$HOME/${NDK_VERSION}

Important: ANDROID_NDK_ROOT must be an absolute path !

If you specify only NDK_VERSION, ANDROID_NDK_ROOT will be automatically set to its default:

export ANDROID_NDK_ROOT=/tmp/${NDK_VERSION}

To specify the minimum SDK version set the environment variable below:

export MIN_SDK_VERSION=21   # Default value if unset

To specify the build directory set the environment variable below:

export ANDROID_BUILD_DIR=${HOME}/android_build

Important: ANDROID_BUILD_ROOT must be an absolute path !

Android build folder

All Android libraries will be generated under:

${ANDROID_BUILD_DIR}/prefix/<arch>/lib

where is one of arm, arm64, x86 or x86_64.

Android build cleanup

You can build your own Android libraries, and place them under ${ANDROID_BUILD_DIR}/prefix//lib, but then, you'll need to indicate the build scripts to not clean this folder, with the help of ANDROID_BUILD_CLEAN

ANDROID_BUILD_CLEAN=no

Dependencies

By default, dependencies are stored under /tmp/tmp-deps, but you can specify another folder with the help of ANDROID_DEPENDENCIES:

ANDROID_DEPENDENCIES_DIR=${HOME}/my_dependencies

If you place your own dependency source trees there, you'll need to specify ANDROID_BUILD_CLEAN=no too.

Cryptographic configuration

The variable CURVE accepts 3 different values:

""          : LIBZMQ is built without any encryption support.
"libsodium" : LIBZMQ is built with LIBSODIUM encryption support (see below).
"tweetnacl" : LIBZMQ is build with embedded encryption support.

Other configuration variables

You can also check configuration variables in build.sh itself, in its "Configuration & tuning options" comment block.

LIBSODIUM

LIBSODIUM is built along with LIBZMQ, when CURVE="libsodium".

• If you have your own clone of LIBSODIUM, set LIBSODIUM_ROOT to point to its folder.
• If the variable LIBSODIUM_ROOT is not set, LIBZMQ will look for a folder 'libsodium' close to his own one.
• If no folder 'libsodium' exists, then LIBZMQ will clone LIBSODIUM from its official STABLE branch.

Build

See chapter Configuration for configuration options and other details.

Select your preferred parameters:

export XXX=xxx
export YYY=yyy
...

And, in the android directory, run:

cd <libzmq>/builds/android
./build.sh [ arm | arm64 | x86 | x86_64 ]

Parameter selection and the calls to build.sh can be located in a SHELL script, like in ci_build.sh.

CI build

Basically, it will call build.sh once, for each Android target.

This script accepts the same configuration variables, but some are set with different default values. For instance, the dependencies are not downloaded or cloned in /tmp/tmp-deps, but inside LIBZMQ clone.

It can be used in the same way than build.sh

export XXX=xxx
export YYY=yyy
cd <libzmq>/builds/android
./ci_build.sh

Dockerfile

An example of Docker file is provided, for Ubuntu 22.04

Minimal changes are required to support Debian 9 to 11.

Minimal changes are required to support CentOS (7 only), Rocky Linux (8 & 9), and many Fedora (22 to 37).