GAPID uses the Bazel build system. The recommended version of Bazel is 1.2.0.

Bazel is able to fetch most of the dependencies required to build GAPID, but currently the Android SDK and NDK both need to be downloaded and installed by hand.

Please see the following OS specific guides for setting up the build environment.

After setting up the build environment, GAPID can be built in a terminal with:

cd <path-to-gapid-source>
bazel build pkg

The build output will be at <path-to-gapid-source>/bazel-bin/pkg.

Follow these instructions to install Chocolatey.

In the console (with administrator privilege) type:

choco install bazel

Note: Installing bazel will also install MSYS into C:\tools\msys64 and Python into C:\tools\python27.

Using the msys64 shell at C:\tools\msys64\mingw64:

1. Update MSYS with: pacman -Syu.
2. If the update ends with “close the window and run it again”, close and reopen the window and repeat 1.
3. Fetch required tools with: pacman -S curl git zip unzip patch
4. Download gcc with: curl -O http://repo.msys2.org/mingw/x86_64/mingw-w64-x86_64-gcc-7.3.0-2-any.pkg.tar.xz
5. Download gcc-libs with: curl -O http://repo.msys2.org/mingw/x86_64/mingw-w64-x86_64-gcc-libs-7.3.0-2-any.pkg.tar.xz
6. Install gcc with: pacman -U mingw-w64-x86_64-gcc*-7.3.0-2-any.pkg.tar.xz
7. Close the MSYS terminal

A JDK is required to build the user interface. If you do not already have a JDK installed, you can install OpenJDK from here (good defaults are version 8 and Hotspot JVM).

Make sure the JAVA_HOME environment variable points to the JDK.

Unzip the Android SDK to a directory of your choosing.

To fetch the required packages, using a console type:

cd <sdk-path>
tools\bin\sdkmanager.bat "platforms;android-26" "build-tools;29.0.2" ndk-bundle

Note: this will install the latest NDK in <sdk-path>\ndk-bundle. The minimum required version of the NDK is r21.

If you do not have adb installed you can do so with:

cd <sdk-path>
tools\bin\sdkmanager.bat platform-tools

Either do this globally or in your shell every time.

Make sure the environment is setup before you run bazel (bazel shutdown will shut it down).

1. Add C:\tools\msys64\mingw64 to the PATH: set PATH=C:\tools\msys64\mingw64\bin;%PATH% Running where gcc should now find mingw’s gcc.

2. Add C:\tools\python27 to the PATH: set PATH=C:\tools\python27;%PATH% Alternatively, pass the path to python via the --python_path to bazel. See the bazel documentation for more info.

3. Set TMP to something very short. C:\tmp is known to work. For faster builds, add this folder to the excemptions of the Windows Defender anti-malware scanner.

The following environment variables will need to be set prior to building:

Follow the MacOS Bazel Install directions to install bazel.

A JDK is required to build the user interface. If you do not already have a JDK installed, you can install OpenJDK from here (good defaults are version 8 and Hotspot JVM).

Make sure the JAVA_HOME environment variable points to the JDK.

Unzip the Android SDK to a directory of your choosing.

To fetch the required packages, using a console type:

cd <sdk-path>
tools/bin/sdkmanager "platforms;android-26" "build-tools;29.0.2" ndk-bundle

Note: this will install the latest NDK in <sdk-path>/ndk-bundle. The minimum required version of the NDK is r16b.

If you do not have adb installed you can do so with:

cd <sdk-path>
tools/bin/sdkmanager platform-tools

After installing, ensure the XCode license is signed with:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license

Bazel can concurrently use more file handles than the OS supports by default. This can be easily fixed by typing:

sudo sysctl -w kern.maxfiles=122880
sudo sysctl -w kern.maxfilesperproc=102400
echo ulimit -S -n 102400 >> ~/.bashrc

Either do this globally or in your shell every time.

Make sure the environment is setup before you run bazel (bazel shutdown will shut it down).

The following environment variables will need to be set prior to building:

Follow the Ubuntu Bazel Install or theFedora/CentOS Bazel Install directions to install bazel.

Alternatively, bazel can be downloaded from its GitHub Releases Page.

A JDK is required to build the user interface. If you do not already have a JDK installed, you can install OpenJDK from here (good defaults are version 8 and Hotspot JVM).

Make sure the JAVA_HOME environment variable points to the JDK.

Unzip the Android SDK to a directory of your choosing.

To fetch the required packages, using a console type:

cd <sdk-path>
tools/bin/sdkmanager "platforms;android-26" "build-tools;29.0.2" ndk-bundle

Note: this will install the latest NDK in <sdk-path>/ndk-bundle. The minimum required version of the NDK is r16b.

If you do not have adb installed you can do so with:

cd <sdk-path>
tools/bin/sdkmanager platform-tools

sudo apt-get update
sudo apt-get install mesa-common-dev libncurses5-dev libgl1-mesa-dev zlib1g-dev

Either do this globally or in your shell every time.

Make sure the environment is setup before you run bazel (bazel shutdown will shut it down).

The following environment variables will need to be set prior to building: