Building from source

Important

We only officially support the 3 major kernels (WindowsNT, Linux, Darwin/XNU), because those are the main ones with ADB binaries available. We can't guarantee UAD-NG will work on other OSes. However, if you have issues running it on POSIX systems, we'd like to know why

1. Install build-dependencies for your target platform:
   • Linux: install a C compiler, such as Clang or GCC. Optionally, install the mold linker (and configure it), for incremental (debug/develop) builds.
   • Windows: ensure MSVC is installed
   • Mac: you might have to run brew install coreutils
2. Install the Rust toolchain.
3. Clone this repository however you like. If you won't contribute PRs then you should only download the contents as:
   • Latest commit

   # https://github.blog/open-source/git/get-up-to-speed-with-partial-clone-and-shallow-clone
   git clone --filter=blob:none https://github.com/Universal-Debloater-Alliance/universal-android-debloater-next-generation

   • GZipped TAR
   • ZIP
4. cd into your local repo
5. And finally, build for distribution, or install for the current machine (respectively):

cargo build --release

cargo install --path . --config 'build.rustflags="-C target-cpu=native"'

Tip

Both of those commands use the release profile by default. You might want the super-optimized opt by adding the --profile=opt flag. That's only recommended if you re-build rarely, as frequent rebuilding of opt defeats the purpose of using it (save time and energy)

To update, repeat from step#3. git pull is recommended if you want to update frequently (saves bandwidth).

If you're a Nix user, start from step#3, and only do step#5 after running:

nix develop

See also