Mobile/Build/Fennec

< Mobile‎ | Build
Revision as of 02:51, 8 June 2008 by Dolske (talk | contribs) (Add a "Running Fennec on Maemo" section.)

Building Fennec and Xulrunner

pull the code from hg

hg clone http://hg.mozilla.org/mozilla-central
cd mozilla-central
hg clone http://hg.mozilla.org/mobile-browser mobile

Your mozconfig should look like this:

# Options for client.mk.
mk_add_options MOZ_BUILD_PROJECTS="xulrunner mobile"
mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../mobilebase

# Global options
#ac_add_options --enable-debug
#ac_add_options --disable-optimize
#ac_add_options --enable-logging
#ac_cv_visibility_pragma=no

#ac_add_options --enable-timeline
ac_add_options --disable-dbus

# XULRunner options
ac_add_app_options xulrunner --enable-application=xulrunner
ac_add_app_options xulrunner --disable-javaxpcom
ac_add_app_options xulrunner --with-arm-kuser

# mobile options
ac_add_app_options mobile --enable-application=mobile
ac_add_app_options mobile --with-libxul-sdk=../xulrunner/dist

# configure will be automatically generated using the 'autoconf-2.13'
# command.  If autoconf-2.13 isn't the right name for your system, as
# is the case on OS X using MacPorts, use the real command name as
# demonstrated below.
mk_add_options AUTOCONF=autoconf213

make sure you have libIDL:

If building for Maemo in Scratchbox, follow the instructions from the Maemo Build page, and remember to set your PKG_CONFIG_PATH environment variable.


then build:

make -f client.mk build

Running Fennec on Maemo

If you did the above in a Maemo Scratchbox for the CHINOOK_ARMEL target, you can run the build on the N800/N810 device.

Create xulrunner and Fennec tarballs:

cd ../mobilebase
cd xulrunner
make package
cd ../fennec
make package

You'll now have tarballs like xulrunner-1.9.1a1pre.en-US.linux-arm.tar.bz2 and fennec-0.3.en-US.linux-arm.tar.bz2 (respectively, under mobilebase/xulrunner/dist and mobilebase/fennec/dist). Copy these to your device (you'll probably want to run bunzip2 on them first, since Maemo doesn't include it).

Extract and launch from a command line (X Terminal) on the device:

$ tar xf xulrunner-1.9.1a1pre.en-US.linux-arm.tar 
$ tar xf fennec-0.3.en-US.linux-arm.tar
$ cd  xulrunner
$ ./xulrunner ../fennec/application.ini

Building Fennec with the Gecko SDK

First download the appropriate Gecko SDK from [1]


Then pull Mozilla (for the build system) Fennec from hg

hg clone http://hg.mozilla.org/mozilla-central
cd mozilla-central
hg clone http://hg.mozilla.org/mobile-browser mobile


Your mozconfig should look like this:

# Options for client.mk.
mk_add_options MOZ_BUILD_PROJECTS="xulrunner mobile"
mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir-fennec


ac_add_options  --enable-application=mobile
ac_add_options  --with-libxul-sdk=<path to the SDK you downloaded and extracted>

Note: if you are building for x86 ubuntu, you will want to add "ac_add_options --disable-dbus" to your mozconfig


And finally, build

make -f client.mk build