HowToMeegoFennecDraft: Difference between revisions

mNo edit summary
 
(44 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== What this is About  ==
== 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.
This document explains "How to build Mobile Firefox for Meego Netbook Platform".<br>  
 
<br>  


== Versions  ==
== Versions  ==
Line 9: Line 7:
This is written for Meego 1.1 SDK. Target Device is the Lenovo Ideapad. Target Platform is the Intel Netbook Release.  
This is written for Meego 1.1 SDK. Target Device is the Lenovo Ideapad. Target Platform is the Intel Netbook Release.  


== Current State ==
== Setup your Netbook ==
 
Build Fails on missing GLIB Dependency


== Steps  ==
I use a Lenovo Ideapad S10-3t supporting multitouch. This is the recommended target device of Intel. [http://meego.com/devices/netbook/installing-meego-your-netbook Follow Instructions]


#Get MeegoSDK<br>Follow the steps from the [http://wiki.meego.com/SDK/Docs/1.1/Getting_started_with_the_MeeGo_SDK_for_Linux official Meego Website]. '''Stop at the point "Install MeeGo Runtime"''', we will continue from this point on.&nbsp;<br>
== Presteps, Install the SDK on your System<br> ==
#Download and install the [http://wiki.meego.com/SDK/Docs/1.1/Configuring_QEMU_runtimes Runtime]<br><pre>sudo mad-admin create -f -e meego-netbook-ia32-qemu-1.1.20101031.2037-sda-runtime</pre> <br>
#Mount the SDK<br>It is important to know that it is not a good idea to use Qemu and the Meego SDK. This is because of:<br>a) In case Qemu crash once, you can not start it again, everything is gone.<br>b) Qemu is very slow on compiling<br>c) For mounting working directories into Qemu you need to use nfs which is possible but increase complexity<br>d) The Image Partitions for netbook and handset are just to small in order to hold the mozilla sources<br><br>Steps:<br>1. Create mount point on your HOST Storage whereever you like it best<br><pre> mkdir ~/meegoSDK </pre> 2. Create a working directory on your HOST Storage whereever you like it best<br><pre> mkdir ~/meegoWorkingDirectory</pre>3. Create a mount point within the meegoSDK Directory<br><pre> mkdir ~/meegoSDK/meegoWorkingDirectory</pre>4. Mount the SDK Image into your Host System<br><pre> 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 </pre> 5. Bind Mount your external Working Directory into the SDK Working Directory<br><pre> mount --bind ~/meegoWorkingDirectory ~/meegoSDK/meegoWorkingDirectory</pre>
#ChangeRoot into MeegoSDK<br>1. Copy the changeroot script from this page (see section "Scripts"<br> 2. Use this script by calling<br><pre>sdk-changeroot ~/meegoSDK</pre>
#Download and install dependencies / needed packages<br><pre>zypper in python-devel docutils libidl-devel libcontentaction-devel alsa-lib-devel gst-plugins-base-devel libffi-devel python sharutils bc quilt yasm wget</pre>
#Get and Compile Mercurial<br>MeegoSDK is missing Mercurial packages, we need to download, compile and install them by our own.<br><pre>cd /meegoWorkingDirectory</pre><pre>wget http://mercurial.selenic.com/release/mercurial-1.7.2.tar.gz </pre><pre>tar -xzf mercurial-1.7.2.tar.gz </pre> <pre>cd mercurial-1.7.2.tar.gz make install cd ..</pre>


#Get Xulrunner Sources from Meego Developer Preview Repository<br><pre>cd /meegoWorkingDirectory </pre> <pre>hg clone http://hg.meego.com/mozilla-central </pre> <pre>hg update -C PRC1 </pre>
Add the package respository of the SDK to your system: [http://wiki.meego.com/SDK/Docs/1.1/Getting_started_with_the_MeeGo_SDK_for_Linux#Configuring_distributions_package_manager (see source for more)]<br>  


#Compile<br>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.<br><pre>make -f client.mk build</pre><br>
==== On Ubuntu or Debian  ====


7. Get it on your Device<br>8. Run it<br>  
<!-- Replaced '#' with <li> so that multi-line <pre> statements would appear in a single block -->  


<br>  
#Add the following line to <code>/etc/apt/sources.list.d/meego-sdk.list</code>.<br> Replace ${distribution}/${version} with one of the following: "debian/5.0", "ubuntu/09.10", "ubuntu/10.04" or "ubuntu/10.10". <pre>deb http://repo.meego.com/MeeGo/sdk/host/repos/${distribution}/${version}/ / </pre>
#Add the repository public key: <pre>$ gpg --keyserver pgpkeys.mit.edu --recv 0BC7BEC479FC1F8A</pre><pre>$ gpg --export --armor 0BC7BEC479FC1F8A | sudo apt-key add -</pre>
#Update the packages database: <pre>$ sudo apt-get update</pre>
#To check that the MeeGo repository has been correctly added, run the following command. The details of the MADDE package should be printed. <pre>$ apt-cache policy madde</pre>


<br>
*Install <pre>$ sudo apt-get install meego-sdk</pre>


= Scripts<br> =
==== On openSUSE ====


== The SDK-Change-Root-Script  ==
*To add the MeeGo repository, run the following command. <br> Replace ${distribution}/${version} with one of the following values: "opensuse/11.2" or "opensuse/11.3". <pre>$ sudo zypper addrepo -f http://repo.meego.com/MeeGo/sdk/host/repos/${distribution}/${version}/meego-sdk.repo</pre>
<pre># 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:
*Install <pre>$ sudo zypper install meego-sdk</pre>
# Haitao Feng &lt;haitao.feng@intel.com&gt;
# Jackie Wu &lt;jackie.wu@intel.com&gt;


CHROOT_NAME=$0
== Configure SDK  ==


usage()
Download the mozilla-meego-assistant script from this website.
{
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()
#Download [[Image:Mozilla-meego-sdk-helper.tar.gz]]<br>
{
#untar the tarbal <br><br>''(the meego-assistant script, will create a mount point and a working directory in the local directory!) you can edit the place by changing the variables in the script.)''<br>
if [ -f $1 ]; then
#<pre>sudo ./meego-assistant install</pre>
count=`cat $1`
if [ "X$count"&nbsp;!= "X" ]; then
count=`expr $count + 1`
echo $count &gt; $1
fi
fi
}


reference_decrease()
== Steps  ==
{
if [ -f $1 ]; then
count=`cat $1`
if [ "X$count"&nbsp;!= "X" ] &amp;&amp; [ $count -gt 0 ]; then
count=`expr $count - 1`
echo $count &gt; $1
fi
fi
}
 
reference_print()
{
if [ -f $1 ]; then
count=`cat $1`
if [ "X$count"&nbsp;!= "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&gt;/dev/null | grep $chroot)
if [ "X$ps"&nbsp;!= "X" ]; then
kill $pid
fi
fi
done


sleep 3
*<pre>sudo ./meego-assistant login</pre>''During first start this finish the configuration of the image. Follow the instructions on screen.<br>''
 
*Get Mozilla Sources and apply Meego Developer Patches on it<br>
# umount directories
<pre>cd /meegoWorkingDirectory
echo umount $chroot/proc
hg clone http://hg.mozilla.org/mozilla-central
umount $chroot/proc
cd mozilla-central
echo umount $chroot/sys
hg clone http://hg.mozilla.org/mobile-browser mobile
umount $chroot/sys
cd mobile/.hg
echo umount $chroot/dev/pts
hg clone http://hg.mozilla.org/users/romaxa_gmail.com/workbase_prc2 patches
umount $chroot/dev/pts
cd patches
echo umount $chroot/dev
hg update -C mobile-browser
umount $chroot/dev
cd ../../../.hg/  
 
hg clone http://hg.mozilla.org/users/romaxa_gmail.com/workbase_prc2 patches
echo umount $chroot/tmp
cd ../  
umount $chroot/tmp
hg qpush --all
 
cd mobile
echo umount $chroot/var/lib/dbus
hg qpush --all
umount $chroot/var/lib/dbus
cd ..
echo umount $chroot/var/run/dbus
</pre>
umount $chroot/var/run/dbus
*Download Mozconfig and start building.
}
<pre>wget https://wiki.mozilla.org/images/7/7c/Mozconfig.tar.gz
 
tar -xzf Mozconfig.tar.gz
if test "x$1" = "x"
make -f client.mk build
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 ] &amp;&amp; [ -e $CHROOT/sys ] &amp;&amp; [ -e $CHROOT/dev ] &amp;&amp; [ -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 &gt; $chroot_reference_count
reference_increase $chroot_reference_count
 
setup $CHROOT
else
if [ "x$2"&nbsp;!= "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"&nbsp;!= "X" ] &amp;&amp; [ $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
</pre>
</pre>


== Mozconfig ==
== Known Issues ==
<pre>export MOZ_ENABLE_GCONF=1                                                                                                               


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


# Global options
Issues with Mesa Drivers. Starting in EGL accelerated version does not work. Fennec is crashing with:
#ac_add_options --enable-debug
<pre>Mesa 7.9 implementation error: glIndexPointer should be mapped to 336, not 314
#ac_add_options --disable-optimize
Please report at bugzilla.freedesktop.org
ac_add_options --disable-installer
Mesa 7.9 implementation error: glUniformMatrix4fv should be mapped to 337, not 485
ac_add_options --disable-crashreporter
Please report at bugzilla.freedesktop.org
ac_add_options --disable-javaxpcom   
</pre>
ac_add_options --enable-printing     
Solution: Disable hardware acceleration within mobile.js
ac_add_options --disable-embedding-tests
ac_add_options --disable-elf-dynstr-gc 
ac_add_options --disable-updater       
ac_add_options --disable-glibtest     


=== Multitouch  ===


# XULRunner options
Multitouch is not working in meego.com release TBI
ac_add_app_options xulrunner --enable-application=xulrunner
ac_add_app_options xulrunner --disable-javaxpcom         


# Disabling tests due to bug 454881
=== Flash Renderspeed  ===
#ac_add_options --disable-tests   


# mobile options
For some people the Renderspeed with native is really slow, it seems to get better when using this for starting fennec:
#ac_add_app_options mobile --enable-application=mobile
<pre> MOZ_QT_GRAPHICSSYSTEM=meego ./fennec -graphicssystem meego </pre>
#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=./build-tree/obj-qt-buildxulrunner
mk_add_options MOZ_MAKE_FLAGS=
</pre>

Latest revision as of 10:00, 13 January 2011

What this is About

This document explains "How to build Mobile Firefox for Meego Netbook Platform".

Versions

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

Setup your Netbook

I use a Lenovo Ideapad S10-3t supporting multitouch. This is the recommended target device of Intel. Follow Instructions

Presteps, Install the SDK on your System

Add the package respository of the SDK to your system: (see source for more)

On Ubuntu or Debian

  1. Add the following line to /etc/apt/sources.list.d/meego-sdk.list.
    Replace ${distribution}/${version} with one of the following: "debian/5.0", "ubuntu/09.10", "ubuntu/10.04" or "ubuntu/10.10".
    deb http://repo.meego.com/MeeGo/sdk/host/repos/${distribution}/${version}/ / 
  2. Add the repository public key:
    $ gpg --keyserver pgpkeys.mit.edu --recv 0BC7BEC479FC1F8A
    $ gpg --export --armor 0BC7BEC479FC1F8A | sudo apt-key add -
  3. Update the packages database:
    $ sudo apt-get update
  4. To check that the MeeGo repository has been correctly added, run the following command. The details of the MADDE package should be printed.
    $ apt-cache policy madde
  • Install
    $ sudo apt-get install meego-sdk

On openSUSE

  • To add the MeeGo repository, run the following command.
    Replace ${distribution}/${version} with one of the following values: "opensuse/11.2" or "opensuse/11.3".
    $ sudo zypper addrepo -f http://repo.meego.com/MeeGo/sdk/host/repos/${distribution}/${version}/meego-sdk.repo
  • Install
    $ sudo zypper install meego-sdk

Configure SDK

Download the mozilla-meego-assistant script from this website.

  1. Download File:Mozilla-meego-sdk-helper.tar.gz
  2. untar the tarbal

    (the meego-assistant script, will create a mount point and a working directory in the local directory!) you can edit the place by changing the variables in the script.)
  3. sudo ./meego-assistant install

Steps

  • sudo ./meego-assistant login
    During first start this finish the configuration of the image. Follow the instructions on screen.
  • Get Mozilla Sources and apply Meego Developer Patches on it
cd /meegoWorkingDirectory 
hg clone http://hg.mozilla.org/mozilla-central 
cd mozilla-central 
hg clone http://hg.mozilla.org/mobile-browser mobile 
cd mobile/.hg 
hg clone http://hg.mozilla.org/users/romaxa_gmail.com/workbase_prc2 patches 
cd patches 
hg update -C mobile-browser 
cd ../../../.hg/ 
hg clone http://hg.mozilla.org/users/romaxa_gmail.com/workbase_prc2 patches 
cd ../ 
hg qpush --all 
cd mobile 
hg qpush --all 
cd ..
  • Download Mozconfig and start building.
wget https://wiki.mozilla.org/images/7/7c/Mozconfig.tar.gz
tar -xzf Mozconfig.tar.gz
make -f client.mk build 

Known Issues

Crash on Start

Issues with Mesa Drivers. Starting in EGL accelerated version does not work. Fennec is crashing with:

Mesa 7.9 implementation error: glIndexPointer should be mapped to 336, not 314
Please report at bugzilla.freedesktop.org
Mesa 7.9 implementation error: glUniformMatrix4fv should be mapped to 337, not 485
Please report at bugzilla.freedesktop.org

Solution: Disable hardware acceleration within mobile.js

Multitouch

Multitouch is not working in meego.com release TBI

Flash Renderspeed

For some people the Renderspeed with native is really slow, it seems to get better when using this for starting fennec:

 MOZ_QT_GRAPHICSSYSTEM=meego ./fennec -graphicssystem meego