This guide walks open-source developers through building the LiteRT GPU
Accelerator shared library (libLiteRtClGlAccelerator.so) from source using
Bazel and ML Drift.
Before starting, ensure your build machine has the following tools installed:
- Host OS: Linux (Ubuntu 20.04+ recommended) or macOS
- Bazel (or Bazelisk)
- Git
- C++ Compiler: Clang 16+ or GCC 11+ with C++17 support
- Python: 3.10+
- Android SDK & NDK: Android NDK r26b (
26.3.11579264) or r21+ recommended for Android builds
git clone https://github.com/google-ai-edge/LiteRT.git
cd LiteRTNote
By default, Bazel automatically fetches the pinned version of
@ml_drift configured in
WORKSPACE. You do not need to clone ml-drift separately unless you want to
build against local ml-drift changes (see
Building with a Local ml-drift Checkout).
Set ANDROID_NDK_HOME to your Android NDK installation path and run Bazel to
build the OpenCL + OpenGL GPU Accelerator (ml_drift_cl_gl_accelerator_so):
export ANDROID_NDK_HOME=/path/to/android-ndk-r26b
bazel build -c opt \
--config=android_arm64 \
--action_env=ANDROID_NDK_HOME=$ANDROID_NDK_HOME \
//litert/runtime/accelerators/gpu:ml_drift_cl_gl_accelerator_soOnce the build completes, the generated shared library is located under
bazel-bin:
bazel-bin/litert/runtime/accelerators/gpu/libLiteRtClGlAccelerator.so
Push the library to your Android device alongside your test binary or application:
adb push bazel-bin/litert/runtime/accelerators/gpu/libLiteRtClGlAccelerator.so /data/local/tmp/If you are developing or testing local modifications to
ML Drift, clone ml-drift and pass
--override_repository=ml_drift=<path> to Bazel:
mkdir -p ~/workspace
cd ~/workspace
# Clone both repositories
git clone https://github.com/google-ai-edge/ml-drift.git
git clone https://github.com/google-ai-edge/LiteRT.git
cd ~/workspace/LiteRT
export ANDROID_NDK_HOME=/path/to/android-ndk-r26b
bazel build -c opt \
--config=android_arm64 \
--action_env=ANDROID_NDK_HOME=$ANDROID_NDK_HOME \
--override_repository=ml_drift=$HOME/workspace/ml-drift \
//litert/runtime/accelerators/gpu:ml_drift_cl_gl_accelerator_soTip
The --override_repository=ml_drift=... flag instructs Bazel to use your
local ml-drift source tree instead of downloading the pinned archive from
GitHub.
The WebGPU accelerator loads Dawn at run
time (libwebgpu_dawn.so, webgpu_dawn.dll). To use your own Dawn, for example
a local checkout with your changes, add --config=dawn_from_source.
bazel build -c opt --config=dawn_from_source \
//litert/runtime/accelerators/gpu:ml_drift_webgpu_accelerator_soOn Windows, build //litert/runtime/accelerators/gpu:libLiteRtWebGpuAccelerator
instead. Building Dawn (Dawn's dependencies are fetched automatically) takes a
few minutes the first time. To build a local Dawn checkout, or pass Dawn CMake
options:
bazel build -c opt --config=dawn_from_source \
--repo_env=LITERT_DAWN_SRC_DIR=$HOME/workspace/dawn \
--repo_env=LITERT_DAWN_CMAKE_ARGS="-DDAWN_USE_X11=ON" \
//litert/runtime/accelerators/gpu:ml_drift_webgpu_accelerator_soA local checkout is compiled as C++20, so on Linux also pass
--cxxopt=-std=c++20 --host_cxxopt=-std=c++20. Dawn is always built in
Release, so use -c opt.
The Dawn library is built in the Bazel output base, in
<output_base>/external/dawn/_litert_dawn_build/ (see bazel info output_base); the build prints its path when it builds Dawn. Copy it next to
the accelerator library and use that directory as the LiteRT runtime library
directory, so that both are found.
| Error | Cause | Solution |
|---|---|---|
ANDROID_NDK_HOME not found / toolchain error |
ANDROID_NDK_HOME is unset or points to an invalid path |
Export ANDROID_NDK_HOME=/path/to/ndk and pass --action_env=ANDROID_NDK_HOME=$ANDROID_NDK_HOME. |
no such package '@@ml_drift//...' |
Invalid path in --override_repository |
Verify $HOME/workspace/ml-drift exists and contains WORKSPACE or MODULE.bazel. |
No MODULE.bazel or WORKSPACE file found |
Wrong directory passed to --override_repository |
Pass the absolute path to the root directory of ml-drift. |
Copyright 2026 Google LLC. Licensed under Apache License 2.0.