MozillaWiki

HowToMeegoFennecDraft: Difference between revisions
mNo edit summary
 
(33 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 ==
 
Configuration successfull, starts building.


Failed with:
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]  
<prev> /build-tree/obj-qt-buildxulrunner/xulrunner/nss/shlibsign: symbol lookup error: /usr/lib/libQtCore.so.4: undefined symbol: _ZdlPv, version GLIBCXX_3.4
make[6]: *** [/build-tree/obj-qt-buildxulrunner/xulrunner/security/manager/../../dist/lib/libsoftokn3.chk] Error 127 </prev>


== Setup your Netbook ==
== Presteps, Install the SDK on your System<br> ==
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]
== Steps ==


#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>
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>  
#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 libXt-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 </pre><pre>make install</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>
#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>


7. Get it on your Device<br>8. Run it<br>
==== On Ubuntu or Debian  ====


<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>


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


== The SDK-Change-Root-Script ==
==== On openSUSE ====
<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:
*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>
# Haitao Feng &lt;haitao.feng@intel.com&gt;
# Jackie Wu &lt;jackie.wu@intel.com&gt;


CHROOT_NAME=$0
*Install <pre>$ sudo zypper install meego-sdk</pre>


usage()
== Configure SDK  ==
{
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 the mozilla-meego-assistant script from this website.
{
if [ -f $1 ]; then
count=`cat $1`
if [ "X$count"&nbsp;!= "X" ]; then
count=`expr $count + 1`
echo $count &gt; $1
fi
fi
}


reference_decrease()
#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" ] &amp;&amp; [ $count -gt 0 ]; then
count=`expr $count - 1`
echo $count &gt; $1
fi
fi
}


reference_print()
== Steps  ==
{
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
 
# 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 ] &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
*<pre>sudo ./meego-assistant login</pre>''During first start this finish the configuration of the image. Follow the instructions on screen.<br>''
unset DBUS_SESSION_BUS_ADDRESS
*Get Mozilla Sources and apply Meego Developer Patches on it<br>
 
<pre>cd /meegoWorkingDirectory
export HOME=/root
hg clone http://hg.mozilla.org/mozilla-central
export PWD=/root
cd mozilla-central
export CHROOTFROM=$CHROOT
hg clone http://hg.mozilla.org/mobile-browser mobile
export DISPLAY=:0.0
cd mobile/.hg
 
hg clone http://hg.mozilla.org/users/romaxa_gmail.com/workbase_prc2 patches
#perform the command in chroot
cd patches
chroot $@
hg update -C mobile-browser
 
cd ../../../.hg/
reference_decrease $chroot_reference_count
hg clone http://hg.mozilla.org/users/romaxa_gmail.com/workbase_prc2 patches
count=`cat $chroot_reference_count`
cd ../
if [ "X$count"&nbsp;!= "X" ] &amp;&amp; [ $count -eq 0 ]; then
hg qpush --all
cleanup $CHROOT
cd mobile
else
hg qpush --all
echo "$CHROOT_NAME: warning: The housekeeping is not done. There might be other meego-chroot running."
cd ..
fi
</pre>
else
*Download Mozconfig and start building.
echo "$CHROOT_NAME: invalid meego chroot directory: $CHROOT";
<pre>wget https://wiki.mozilla.org/images/7/7c/Mozconfig.tar.gz
exit;
tar -xzf Mozconfig.tar.gz
fi
make -f client.mk build
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 --disable-install-strip --disable-jemalloc --disable-logging --disable-logrefcnt --enable-tests --enable-mochitest --enable-system-ffi --enable-meegotouch --prefix=/usr
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
Retrieved from "https://wiki.mozilla.org/index.php?title=HowToMeegoFennecDraft&oldid=277508"