HowToMeegoFennecDraft

What this is About

This is a WIP document about "How to build Mobile Firefox for Meego Platform". Its not yet working, understand this page as open documentation and feel free to improve the steps.

Versions

This is written for Meego 1.1 SDK. Target Device is the Lenovo Ideapad. Target Platform is the Intel Netbook Release.

Current State

Build Fails on missing GLIB Dependency

Steps

1. Get MeegoSDK
   Follow the steps from the official Meego Website. Stop at the point "Install MeeGo Runtime", we will continue from this point on. 
   
2. Download and install the Runtime
   sudo mad-admin create -f -e meego-netbook-ia32-qemu-1.1.20101031.2037-sda-runtime
   
3. Mount the SDK
   It is important to know that it is not a good idea to use Qemu and the Meego SDK. This is because of:
   a) In case Qemu crash once, you can not start it again, everything is gone.
   b) Qemu is very slow on compiling
   c) For mounting working directories into Qemu you need to use nfs which is possible but increase complexity
   d) The Image Partitions for netbook and handset are just to small in order to hold the mozilla sources
   
   Steps:
   1. Create mount point on your HOST Storage whereever you like it best
   (ie. mkdir ~/meegoSDK)
   
   2. Create a working directory on your HOST Storage whereever you like it best
   (ie. mkdir ~/meegoWorkingDirectory)
   
   3. Create a mount point within the meegoSDK Directory
   (ie. mkdir ~/meegoSDK/meegoWorkingDirectory)
   
   4. Mount the SDK Image into your Host System
   (ie. mount -o loop,offset=512 /usr/lib/madde/linux-i686/runtimes/meego-netbook-ia32-qemu-1.1.20101031.2037-sda-runtime/meego-netbook-ia32-qemu-1.1.20101031.2037-sda.raw ~/meegoSDK
   
   5. Bind Mount your external Working Directory into the SDK Working Directory
   (ie. mount --bind ~/meegoWorkingDirectory ~/meegoSDK/meegoWorkingDirectory)
   
4. ChangeRoot into MeegoSDK
   1. Copy the changeroot script from this page (see section "Scripts"
   2. Use this script by calling
   sdk-changeroot ~/meegoSDK
   
5. Download and install dependencies / needed packages
   
   zypper in python-devel docutils libidl-devel libcontentaction-devel alsa-lib-devel gst-plugins-base-devel libffi-devel python sharutils bc quilt yasm wget
   
   
6. Get and Compile Mercurial
   MeegoSDK is missing Mercurial packages, we need to download, compile and install them by our own.
   
   cd /meegoWorkingDirectory
   wget http://mercurial.selenic.com/release/mercurial-1.7.2.tar.gz
   tar -xzf mercurial-1.7.2.tar.gz
   cd mercurial-1.7.2.tar.gz
   make install
   cd ..
   
7. Get Xulrunner Sources from Meego Developer Preview Repository (based on Firefox Mobile Beta 2)
   cd /meegoWorkingDirectory
   hg clone http://hg.meego.com/mozilla-central
   hg update -C PRC1
   
   
8. Compile
   The checkout there is still debian based, this needs to be adjusted. For now its good enough to use the mozconfig provided in the bottom of this page.
   
   make -f client.mk build
   
   
   
   

7. Get it on your Device
8. Run it

Scripts

The SDK-Change-Root-Script

# Copyright 2010, Intel Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 2 of the License.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Library General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

# Authors:
# Haitao Feng <haitao.feng@intel.com>
# Jackie Wu <jackie.wu@intel.com>

CHROOT_NAME=$0

usage()
{
echo Usage: "$CHROOT_NAME NEWROOT [COMMAND [ARG]...]"
echo " or: $CHROOT_NAME OPTION"
echo "Run COMMAND with root directory set to NEWROOT."
echo
echo " OPTIONS:"
echo " --help display this help and exit"
echo
echo "If no command is given, run ``${SHELL} -i''"
}

reference_increase()
{
if [ -f $1 ]; then
count=`cat $1`
if [ "X$count" != "X" ]; then
count=`expr $count + 1`
echo $count > $1
fi
fi
}

reference_decrease()
{
if [ -f $1 ]; then
count=`cat $1`
if [ "X$count" != "X" ] && [ $count -gt 0 ]; then
count=`expr $count - 1`
echo $count > $1
fi
fi
}

reference_print()
{
if [ -f $1 ]; then
count=`cat $1`
if [ "X$count" != "X" ]; then
echo "The reference count of [$1]: $count"
fi
fi
}

setup()
{
chroot=$1
# normal preparation for chroot
echo mount --bind /proc $chroot/proc
mount --bind /proc $chroot/proc
echo mount --bind /sys $chroot/sys
mount --bind /sys $chroot/sys
echo mount --bind /dev $chroot/dev
mount --bind /dev $chroot/dev
echo mount --bind /dev/pts $chroot/dev/pts
mount --bind /dev/pts $chroot/dev/pts

# preparation for X
# X sockets are at /tmp/.X11-unix
# echo mount --bind /tmp $chroot/tmp
# mount --bind /tmp $chroot/tmp

# preparation for dbus
# echo mount --bind /var/lib/dbus $chroot/var/lib/dbus
# mount --bind /var/lib/dbus $chroot/var/lib/dbus
# echo mount --bind /var/run/dbus $chroot/var/run/dbus
# mount --bind /var/run/dbus $chroot/var/run/dbus

# preparation for network
echo cp /etc/resolv.conf $chroot/etc/resolv.conf
cp /etc/resolv.conf $chroot/etc/resolv.conf
}

cleanup()
{
chroot=$1
#clean up processes using chroot
pid_set=$( ps ax | awk '{ print $1 }')
for pid in $pid_set
do
if [ -h /proc/$pid/root ]; then
ps=$( ls -l /proc/$pid/root 2>/dev/null | grep $chroot)
if [ "X$ps" != "X" ]; then
kill $pid
fi
fi
done

sleep 3

# umount directories
echo umount $chroot/proc
umount $chroot/proc
echo umount $chroot/sys
umount $chroot/sys
echo umount $chroot/dev/pts
umount $chroot/dev/pts
echo umount $chroot/dev
umount $chroot/dev

echo umount $chroot/tmp
umount $chroot/tmp

echo umount $chroot/var/lib/dbus
umount $chroot/var/lib/dbus
echo umount $chroot/var/run/dbus
umount $chroot/var/run/dbus
}

if test "x$1" = "x"
then
echo "$CHROOT_NAME: missing operand";
echo "Try '$CHROOT_NAME --help' for more information";
exit;
fi

if [ -e $1 ]; then
CHROOT=$(readlink -f $1)
if [ -e $CHROOT/proc ] && [ -e $CHROOT/sys ] && [ -e $CHROOT/dev ] && [ -e $CHROOT/dev/pts ]; then
chroot_reference_count=`echo $CHROOT | sed 's/\//_/g'`
chroot_reference_count=/tmp/meego_chroot$chroot_reference_count.ref_count
chroot_mount=$( mount | grep $CHROOT/proc )
if [ "X$chroot_mount" = "X" ]; then
touch $chroot_reference_count
echo 0 > $chroot_reference_count
reference_increase $chroot_reference_count

setup $CHROOT
else
if [ "x$2" != "x" ]; then
if [ $2 = "force-clean" ]; then
echo "$CHROOT_NAME: clean up meego chroot $CHROOT"
cleanup $CHROOT
exit;
fi
fi
reference_increase $chroot_reference_count
fi

#patch from Graham Cobb, see bug #3156 for detail
unset DBUS_SESSION_BUS_ADDRESS

export HOME=/root
export PWD=/root
export CHROOTFROM=$CHROOT
export DISPLAY=:0.0

#perform the command in chroot
chroot $@

reference_decrease $chroot_reference_count
count=`cat $chroot_reference_count`
if [ "X$count" != "X" ] && [ $count -eq 0 ]; then
cleanup $CHROOT
else
echo "$CHROOT_NAME: warning: The housekeeping is not done. There might be other meego-chroot running."
fi
else
echo "$CHROOT_NAME: invalid meego chroot directory: $CHROOT";
exit;
fi
else
if [ $1 = "--help" ]; then
usage;
else
echo "$CHROOT_NAME: invalid meego chroot directory: $CHROOT";
echo "Try '$CHROOT_NAME --help' for more information";
fi
fi

Mozconfig

export MOZ_ENABLE_GCONF=1                                                                                                                 

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

# Global options
#ac_add_options --enable-debug
#ac_add_options --disable-optimize
ac_add_options --disable-installer
ac_add_options --disable-crashreporter
ac_add_options --disable-javaxpcom    
ac_add_options --enable-printing      
ac_add_options --disable-embedding-tests
ac_add_options --disable-elf-dynstr-gc  
ac_add_options --disable-updater        
ac_add_options --disable-glibtest       


# XULRunner options
ac_add_app_options xulrunner --enable-application=xulrunner
ac_add_app_options xulrunner --disable-javaxpcom           

# Disabling tests due to bug 454881
#ac_add_options --disable-tests    

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

# Disable wifi support in necko
ac_add_options --disable-necko-wifi

# Less disk space, faster startup, we are not using accessibility, on device
ac_add_options --disable-accessibility

ac_add_options --disable-thumb2

ac_add_options --enable-gstreamer
#ac_add_options --disable-ogg
#ac_add_options --disable-webm

ac_add_options --enable-cpp-rtti

export LDFLAGS="-Wl,--no-keep-memory"
LDFLAGS="-Wl,--no-keep-memory"
ac_add_options  --enable-default-toolkit=cairo-qt --with-maemo-version=6 --disable-elf-dynstr-gc --with-arm-kuser --disable-install-strip --disable-jemalloc --disable-logging --disable-logrefcnt --enable-tests --enable-mochitest --enable-system-ffi --enable-meegotouch --enable-optimize="-g -O3  -D__ARM_PCS_VFP=1 " --prefix=/usr --build=arm-linux-gnueabi
mk_add_options MOZ_OBJDIR=/scratchbox/newworld/mozilla-central-Pilots-RC1/build-tree/obj-qt-nojit-armel-sb-syscairo-syspixman-sysffi-buildxulrunner
mk_add_options MOZ_MAKE_FLAGS=