Building the Android version on non Android OS · DNSCrypt/dnscrypt-proxy Wiki · GitHub
Skip to content

Building the Android version on non Android OS

Jump to bottom Edit New page
Frank Denis edited this page Sep 28, 2026 · 10 revisions

There are some extra steps to take before you can successfully build the Android version of dnscrypt-proxy on Linux or Windows. Following the main guide only will not work.

First download and extract the Android NDK r15c (r16b gives a warning with arm64 binaries, see ndk #602).

Android-ndk-r18-beta2 and later can build for API 16. On previous versions, use -D__ANDROID_API__=19.

Now create the standalone toolchain. You'll need to install Python if you don't have it already.

# Set paths for the extracted ndk and standalone toolchain install

# Windows (PowerShell)
$NDK_TOOLS="android-ndk-r15c"
$INSTALL_DIR="ndk-standalone-r15c"
$MAKE_TOOLCHAIN="$NDK_TOOLS/build/tools/make_standalone_toolchain.py"

# Linux
NDK_TOOLS=android-ndk-r15c
INSTALL_DIR=ndk-standalone-r15c
MAKE_TOOLCHAIN=$NDK_TOOLS/build/tools/make_standalone_toolchain.py

# Create standalone toolchain, omitting any archs you don't need.
python $MAKE_TOOLCHAIN --arch arm64  --install-dir $INSTALL_DIR/arm64
python $MAKE_TOOLCHAIN --arch arm    --install-dir $INSTALL_DIR/arm
python $MAKE_TOOLCHAIN --arch x86_64 --install-dir $INSTALL_DIR/x86_64
python $MAKE_TOOLCHAIN --arch x86    --install-dir $INSTALL_DIR/x86

The next steps should be done during step 4 of the main guide; they set extra environment variables.

Add the standalone NDK executables to the path. Again, omit any architectures you don't need. NDK_STANDALONE should be the full path to INSTALL_DIR from the previous step.

# Windows (PowerShell)
$NDK_STANDALONE=
$env:Path += ";$NDK_STANDALONE/arm64/bin"
$env:Path += ";$NDK_STANDALONE/arm/bin"
$env:Path += ";$NDK_STANDALONE/x86_64/bin"
$env:Path += ";$NDK_STANDALONE/x86/bin"

# Linux
NDK_STANDALONE=
PATH=$PATH:$NDK_STANDALONE/arm64/bin
PATH=$PATH:$NDK_STANDALONE/arm/bin
PATH=$PATH:$NDK_STANDALONE/x86_64/bin
PATH=$PATH:$NDK_STANDALONE/x86/bin

Then set the compile commands to the standalone NDK clang. This must be set for each different architecture you build (that is, for each go build command).

# Windows (PowerShell)
$env:CC="aarch64-linux-android-clang"
$env:CCX="aarch64-linux-android-clang++"

# Linux aarch64
export CC=aarch64-linux-android-clang
export CCX=aarch64-linux-android-clang++

# Linux armv6
export CC=arm-linux-androideabi-clang
export CCX=arm-linux-androideabi-clang++

Finally, the cgo system should be enabled.

# Windows (PowerShell)
$env:CGO_ENABLED=1

# Linux
export CGO_ENABLED=1

Are these instructions not clear? Wrong? Insufficient? This documentation page is a Wiki, so you can contribute by improving it!

Clone this wiki locally