Android

Android

Central location for information about the Android port of Gecko.

Current Status

• Full tree builds
  • NO NSS support (needs NSS build system hacking)
• JS builds and shell runs
• xpcshell builds and runs

Getting Source Code

Currently, the source lives in a user hg repo:

http://hg.mozilla.org/users/vladimir_mozilla.com/mozilla-droid

Building

Prerequisites

• Standard Linux build environment, at least as far as tools like gnu make, gcc, and autoconf2.13 go
• Android 1.6 NDK

The NDK is the only Android-specific prereq for building, though you will probably want the Android SDK for an emulator and tools such as 'adb'. Either 2.0 or 1.6 will do.

Quickstart (Linux)

Just paste these commands into your terminal to download and install the NDK and SDK.

# get SDK and NDK
wget http://dl.google.com/android/android-sdk_r04-linux_86.tgz &&
wget http://dl.google.com/android/ndk/android-ndk-1.6_r1-linux-x86.zip &&

# unpack SDK and NDK
unzip android-ndk-1.6_r1-linux-x86.zip &&
tar xvfz android-sdk_r04-linux_86.tgz &&

# setup NDK
cd android-ndk-1.6_r1 &&
build/host-setup.sh &&
cd ..

The SDK needs to be setup manually.

• In the SDK directory, run tools/android
• Check Settings->Force https://... sources to be fetched using http://...
• Click Save & Apply
• Installed Packages->Update All...
• You may uncheck everything you don't need. Just installing the latest 1.x and 2.x SDKs is fine.
• Click Install Accepted

Building

Fix headers

Certain header files in the NDK do not compile as C++. Paste this command in your terminal while in the NDK directory to patch them.

patch -p1 << "EOF"
--- tmp/android-ndk-1.6_r1/build/platforms/android-4/arch-arm/usr/include/asm-generic/siginfo.h   2009-07-28 17:26:01.000000000 -0700
+++ android-ndk-1.6_r1/build/platforms/android-4/arch-arm/usr/include/asm-generic/siginfo.h       2009-12-09 11:48:46.000000000 -0800
@@ -55,7 +55,7 @@
  struct {
  timer_t _tid;
  int _overrun;
- char _pad[sizeof( __ARCH_SI_UID_T) - sizeof(int)];
+ //char _pad[sizeof( __ARCH_SI_UID_T) - sizeof(int)];
  sigval_t _sigval;
  int _sys_private;
  } _timer;
--- tmp/android-ndk-1.6_r1/build/platforms/android-4/arch-arm/usr/include/dlfcn.h 2009-07-28 17:26:01.000000000 -0700
+++ android-ndk-1.6_r1/build/platforms/android-4/arch-arm/usr/include/dlfcn.h     2009-12-09 11:51:20.000000000 -0800
@@ -42,7 +42,7 @@
   RTLD_LAZY = 1,

   RTLD_LOCAL  = 0,
-  RTLD_GLOBAL = 2,
+  RTLD_GLOBAL = 2
 };

 #define RTLD_DEFAULT  ((void*) 0xffffffff)
EOF

Full Build

Normal build, with the following mozconfig:

ac_add_options --enable-application=browser

ac_add_options --disable-ogg
ac_add_options --disable-wave

ac_add_options --with-arm-kuser

# Global options
ac_add_options --enable-debug
ac_add_options --disable-optimize

# mobile options
ac_add_options --disable-installer
ac_add_options --disable-crashreporter
ac_add_options --disable-printing
ac_add_options --disable-javaxpcom

# android options
ac_add_options --target=arm-android-eabi
ac_add_options --with-android-ndk="$PWD/../android-ndk-1.6_r1"
ac_add_options --with-endian=little
ac_add_options --enable-tree-freetype

# other options
ac_add_options --disable-necko-wifi
ac_add_options --disable-plugins

# to fix
ac_add_options --disable-crypto
# ssltunnel can't build if we disable crypto
ac_add_options --disable-tests

This assumes the ndk was installed in the parent directory.

JS/NSPR only

In the commands below, replace these with the appropriate paths:

$NDK is the NDK location
$moz is the mozilla-droid repo checkout
$out is some base destination directory

First, regenerate configure in the js dir (the nspr configure is checked in):

% cd $moz/js/src && autoconf2.13

Then create a nspr directory, configure nspr, and build it:

% cd $out
% mkdir nspr
% cd nspr
% $moz/nsprpub/configure \
   --target=arm-android-eabi \
   --with-android-ndk=$NDK 
% make -s

Then do the same for JS, telling it where to find the NSPR you just built:

% cd $out
% mkdir js
% cd js
% $moz/js/src/configure \
   --target=arm-android-eabi \
   --with-android-ndk=$NDK \
   --with-nspr-cflags=-I$out/nspr/dist/include/nspr \
   --with-nspr-libs='-L$out/nspr/dist/lib -lnspr4 -lplc4 -lplds4' \
   --enable-threadsafe \
   --with-endian=little \
   --with-arm-kuser
% make -s

Running

You'll need to copy the NSPR libraries and the js shell to the emulator or your device. Whether you're running on a physical device or an emulator, /data/local should be writable by the user.

% cd $out/nspr/dist/lib
% for f in *.so ; do adb push $f /data/local ; done
% cd $out/js/shell
% adb push js /data/local

Then, connect to a shell on the device, and run js (adb shell prompts prefixed with "android"):

% adb shell
android% cd /data/local
android% LD_LIBRARY_PATH=. ./js
js> 1+1
2

Other Resources

• Joel's Notes
• Vlad's Notes
• Vlad's Test App Hg Repo