Android

Radare2 can be cross-compiled for other architectures/systems as well, like Android.

Prerequisites

  • Python 3
  • Meson
  • Ninja
  • Git
  • Android NDK

Step-by-step

Download and extract the Android NDK

Download the Android NDK from the official site and extract it somewhere on your system (e.g. /tmp/android-ndk)

Make

Specify NDK base path
  1. $ echo NDK=/tmp/android-ndk  > ~/.r2androidrc
Compile + create tar.gz + push it to connected android device
  1. ./sys/android-build.sh arm64-static

You can build for different architectures by changing the argument to ./sys/android-build.sh. Run the script without any argument to see the accepted values.

Meson

Create a cross-file for meson

Meson needs a configuration file that describes the cross compilation environment (e.g. meson-android.ini). You can adjust it as necessary, but something like the following should be a good starting point:

  1. [binaries]
  2. c       = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android28-clang'
  3. cpp     = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android28-clang++'
  4. ar      = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-ar'
  5. as      = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-as'
  6. ranlib  = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-ranlib'
  7. ld      = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-ld'
  8. strip   = '/tmp/android-ndk/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-strip'
  9. pkgconfig = 'false'
  11. [properties]
  12. sys_root = '/tmp/android-ndk/sysroot'
  14. [host_machine]
  15. system = 'android'
  16. cpu_family = 'arm'
  17. cpu = 'aarch64'
  18. endian = 'little'
Compile with meson + ninja

Now setup the build directory with meson as usual:

  1. $ CFLAGS="-static" LDFLAGS="-static" meson --default-library static --prefix=/tmp/android-dir -Dblob=true build --cross-file ./meson-android.ini

A bit of explanation about all the options:

  • CFLAGS="-static", LDFLAGS="-static", --default-library static: this ensure that libraries and binaries are statically compiled, so you do not need to properly set LD_* environment variables in your Android environment to make it find the right libraries. Binaries have everything they need inside.
  • -Dblob=true: it tells meson to compile just one binary with all the needed code for running radare2, rabin2, rasm2, etc. and creates symbolic links to those names. This avoids creating many statically compiled large binaries and just create one that provides all features. You will still have rabin2, rasm2, rax2, etc. but they are just symlinks to radare2.
  • --cross-file ./meson-android.ini: it describes how to compile radare2 for Android

Then compile and install the project:

  1. $ ninja -C build
  2. $ ninja -C build install
Move files to your android device and enjoy

At this point you can copy the generated files in /tmp/android-dir to your Android device and running radare2 from it. For example:

  1. $ cd /tmp && tar -cvf radare2-android.tar.gz android-dir
  2. $ adb push radare2-android.tar.gz /data/local/tmp
  3. $ adb shell
  4. DEVICE:/ $ cd /data/local/tmp
  5. DEVICE:/data/local/tmp $ tar xvf radare2-android.tar.gz
  6. DEVICE:/data/local/tmp $ ./android-dir/bin/radare2
  7. Usage: r2 [-ACdfLMnNqStuvwzX] [-P patch] [-p prj] [-a arch] [-b bits] [-i file]
  8.           [-s addr] [-B baddr] [-m maddr] [-c cmd] [-e k=v] file|pid|-|--|=