These tools can be used to compile and package the Xposed framework. They are especially useful when it comes to releasing files for various platforms and Android versions. Note that Xposed by itself is quite complicated and not suitable for beginners. You'll need a certain level of experience with C++ and general software development in order to build and modify Xposed by yourself.
General note on forks and custom builds
Xposed is open-source and contributions are very welcome. The files in this repository hopefully make it easier to compile custom versions for testing and improvements. However, please be careful when you publish your own versions. Make clear that it's an unofficial version to avoid confusion, and also remember to give proper attribution. Your version probably still includes 99% or more of the original source code that has been written since 2012, so it wouldn't be fair to make it sound like you did all the work. Also, if you made some fixes or improvements, it's in everyone's interest that you create a pull request and contribute them back to the original project.
Build script (build.pl)
This script can perform the following steps:
- Compile the native executables (
app_process), libraries (
libxposed_*.so) and the modified ART runtime.
- Collect these files and put them into a common output directory.
- Create the
xposed.propfile that serves as label for the published package.
- Create a flashable ZIP file to install the Xposed framework.
It can also compile the Java part of the framework, called
You can call
./build.pl --help to get a list of allowed options. Usually, it's enough to specify the
-t option, e.g
./build.pl -t arm,x86:21 to build ARM and x86 files for SDK 21 (Android 5.0).
You will need to have Perl installed to run this script. It also requires some Perl modules, some of which might not be pre-installed. Depending on your distribution, you can install them using your OS package manager (like apt-get, packages could be named
lib*-perl) or via
cpan <modulename>. Please look up the details for your installation yourself.
AOSP source tree
If you have never built the native parts of Xposed before, you obviously need to download the source code. The Xposed source is placed in the complete AOSP source tree, so it's not enough to download just the SDK/NDK. Instead, please follow the official instructions to download the full source of the Android version that you want to build for. If you have done everything right, the command
make -j4 app_process should succeed. Please note that I can't support you with these steps.
Xposed source code
Once you have the AOSP source ready, you can integrate the Xposed sources into it. There are at least three ways to do so:
This is probably the easiest way to get started. Go to the root directory of the AOSP directory. Change into the
.repo subdirectory and create a folder called
local_manifests. Then create a symbolic link to one of the manifests that are included in this repository, e.g.
ln -s /path/to/this/repository/local_manifests/xposed_sdk21.xml .. Afterwards, go back to the AOSP root directory and run
repo sync again. This will also help to avoid some failures when compiling older Android versions on recent VMs.
If you're afraid that
repo sync might overwrite your changes or for some other reasons you don't want to use it, you can also clone the repositories manually. First, navigate to the
framework/base/cmds directory and execute
git clone https://github.com/rovo89/Xposed.git xposed. This repository contains the modified
app_process executable and the
For variants that include ART, you will also need to replace
art folder. However, you have to be careful that the
repo sync command doesn't interfere with the new directory. For this, follow the steps above to activate the
remove_art.xml manifest and run
repo sync. This should already remove the
art directory in the AOSP root, but otherwise, just remove it manually. Then execute
git clone https://github.com/rovo89/android_art.git art to download the modified files.
In case you have many AOSP trees and want to keep the Xposed source in sync for all of them (i.e. make one change and apply it to all SDKs immediately), you can also look into bind mounts. It's basically the same as manual cloning, but you clone the files into a separate directory and then use bind mounts to map them into the AOSP tree. This is a pretty advanced technique, so I won't go into details here.
XposedBridge source code (or prebuilt file)
If you want to compile
XposedBridge.jar yourself, clone https://github.com/rovo89/XposedBridge and set the
javadir variable accordingly. Make sure that the Gradle build is working fine, the Android SDK and other dependencies need to be installed for this. Then you can call
./build.pl -a java to build and copy the JAR.
If you want to use a prebuilt file instead, copy it to a
java subfolder in the
outdir that you have configured in
build.conf. For example, if
outdir is set to
/android/out, then the file should be stored in
build.pl script requires some configuration. The settings are stored in INI file format in
As the configuration is specific to your local machine, it's not included in the GitHub repository. There is, however, a file called
build.conf.sample with some examples. You can either copy it to
build.conf or create your own file based on it.
outdir: The output directory for compiled files. All Xposed-specific executables/libraries are copied here, and it's used to store log files and the flashable ZIP. This directory must exist.
javadir: (Optional) The directory that XposedBridge has been checked out to (see above).
version: The version number that is stored in the
/system/xposed.prop file. It's displayed in various places, e.g. while flashing the ZIP file or in the installer. It's also the API version for Xposed, so please make sure that you use the version number that your build is based on. You're free to add any custom suffix with your own version number. You can use the placeholder
%s to insert the current date in
makeflags: Additional parameters to pass to each
make command. The default value is
-j4, which enables parallel build with 4 jobs.
sign: (Optional) Might be
all to sign all build, or
release to sign only release builds (
-r parameter) using
gpg -ab <file>.
user: (Optional) This is passed as
-u parameter to the
gpg command, see its man page for allowed formats.
The parameters in this section tell the build script where the AOSP source trees (see above) are stored for each Android version. The key is the SDK version, the value is the directory.
In case you want to compile the specialized BusyBox fork from https://github.com/rovo89/android_external_busybox, you have to add a mapping of platform to an Android SDK version. In the source tree for this SDK version, you have to check out the project into the folder