Compile Waydroid - Using Android-Generic Project

For those not aware, Android-Generic Project, which is best known for bringing PC targets to AOSP based ROMs, also supports Waydroid targets too.

This documentation will go over how to use AG for compiling Waydroid.

Getting started

To get started with Android/Lineage OS, you'll need to get familiar with Repo , Version Control with Git and Android-Generic Project documentation


To initialize your local repository using the Lineage OS trees, use a command like this:

repo init -u -b lineage-18.1 --git-lfs

Then we grab the Android-Generic and Waydroid bits:

wget -O - | bash
git clone vendor/ag


Then we can sync up:

repo sync

And setup the local build environment:

. build/


Legacy Method:

The legacy method is driven by a simple bash script found in vendor/ag/legacy-scripts/waydroid-build/

bash vendor/ag/legacy-scripts/waydroid-build/ --help
Compiles and packages Waydroid for target arch

	waydroid_build [-a|--arch arm|arm64|x86|x86_64] [-c|--clean] [-p|--package] [-r|--rom_name Name]
	-a|--arch (option) Specify arch for build (arm, arm64, x86, x86_64)
	-c|clean     Run 'make clean' before build
	-p|--package     Package build using ROM_NAME
	-r|--rom_name (ROM_NAME) Name used for package build filename (ex: Lineage-17.1)

So to compile Waydroid for x86_64, making clean, and package it in a .zip. You would use this command:

bash vendor/ag/legacy-scripts/waydroid-build/ -a x86_64 -c -p

GUI Method:

We now want to use AG for the following portions. So in the terminal, type:

ag-menu waydroid

You should now see a menu like this:

We can skip the first 2 steps (01-generate-manifest-gui & 02-sync-project), and continue to the


Click on it and hit OK.

This will start to apply all the waydroid patches on top of Lineage OS. If there are any conflicts, please refer to the Manual Patch Resolution doc. Otherwise, you can continue to the next step.


The build options are mostly the same as native PC builds, so we can explore them a little.

Select Product Type:

This will let you select the target device for compiling

Select Variant Type:

This will allow you to select the variant type (user, userdebug, eng). Userdebug is the most common for testing.

Select Apps Type:

!!WARNING - NOT ALL ARCH TARGETS ARE FULLY SUPPORTED YET!! This will let you compile Waydroid with various app types included (FOSS, GMS, EMU-Gapps, OpenGapps & Vanilla)

Select Desktop Mode Integration:

Waydroid by default includes one type of custom Desktop Mode UI, and that is Boringdroid. This will let you select an alternative option to package along side.

Select Extra Options:

Make Clean before build - Self explanatory, it runs 'make clean' before compiling

Generate Package .zip - Generated a package .zip after compile if complete (requires 7zz & simg2img to be installed)

Run Make Clean:

Just runs 'make clean', nothing fancy

Start the Build:

This will launch the compile with all the selected portions from above. If it requires any missing information, the terminal or popup window will let you know.

From here, things are pretty much 1:1 for AG's PC build instructions, so you can refer to the Android-Generic Project Documentation for further instructions

Last updated