Collabora Notes: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 5: Line 5:
Collaborans are interested in building E10s on a machine on which Scratchbox is also installed, on which the Maemo SDK can be installed, and on which one can cross-compile to the ARM architecture.  
Collaborans are interested in building E10s on a machine on which Scratchbox is also installed, on which the Maemo SDK can be installed, and on which one can cross-compile to the ARM architecture.  


= XEN IMAGE =
= XEN IMAGE =


One way to obtain the desired build environment is to obtain a virtual machine image that is properly configured. I (robin_bb) have created such an image. It was current in August 2009.  
One way to obtain the desired build environment is to obtain a virtual machine image that is properly configured. I (robin_bb) have created such an image. It was current in August 2009.  
Line 15: Line 15:
In order to use that image, you'll need the [http://www.xen.org/ Xen virtual machine] correctly installed and setup on your box.  
In order to use that image, you'll need the [http://www.xen.org/ Xen virtual machine] correctly installed and setup on your box.  


= MANUAL&nbsp;SETUP<br> =
= MANUAL&nbsp;SETUP =


== Installing Scratchbox Apophis  ==
== Installing Scratchbox Apophis  ==


''NOTE: There are actually two scratchbox versions supported by Nokia, namely Scratchbox 1.0 (Apophis) and Scratchbox2. Both allow electrolysis to build under maemo for ARM processors, but this document will only pertain to version 1.0.''<br>
''NOTE: There are actually two scratchbox versions supported by Nokia, namely Scratchbox 1.0 (Apophis) and Scratchbox2. Both allow electrolysis to build under maemo for ARM processors, but this document will only pertain to version 1.0.'' See <span style="text-decoration: underline;">Maemo</span>[https://projects.maemo.org/trac/sdk/wiki/Harmattan-sb1 's scratchbox for harmattan wiki page].


==== Install from repositories<br> ====
==== Install from your regular repositories<br> ====


If you're running DEBIAN or UBUNTU, there's good chances that your distro's repositories keep an up-to-date version of Scratchbox Apophis. If so, install it throught the package manager.
If you're running DEBIAN or UBUNTU, there's good chances that your distro's repositories keep an up-to-date version of Scratchbox Apophis. If so, install it throught the package manager and all relevant devkits and toolchains suggested in [https://projects.maemo.org/trac/sdk/wiki/Harmattan-sb1 here].  


==== Install manually<br> ====
==== Install manually from files.maemo.org<br> ====


In any cases, you can also manually install Scratchbox 1.0. In order to build [https://developer.mozilla.org/en/Build_Documentation firefox], [https://wiki.mozilla.org/Mobile/Build fennec] or [https://wiki.mozilla.org/Content_Processes/Build e10s] (electrolysis) for the maemo platform on the N810, N900 (rover) or Devlon-2, you have to cross-compile the mozilla codebase for the ARM processor.  
In any other cases, you can also manually install Scratchbox 1.0.


For that, you need [http://www.scratchbox.org/download/ Scratchbox Apophis].  
For that, you need [http://www.scratchbox.org/download/ Scratchbox Apophis].  


<br>


 
<br>
 


Once you have scratchbox installed, you can clone the mozilla codebase repository.  
Once you have scratchbox installed, you can clone the mozilla codebase repository.  
Line 53: Line 53:
As a Collabora developer, you might be targetting a specific maemo platform version.  
As a Collabora developer, you might be targetting a specific maemo platform version.  


== Pulling the mozilla codebase<br> ==
== Pulling the mozilla codebase<br> ==


== Building<br> ==
== Building<br> ==


== Running/Testing your build<br> ==
== Running/Testing your build<br> ==


<br>  
<br>  
Line 63: Line 63:
== Building E10s  ==
== Building E10s  ==


= BUILDING&nbsp;UNDER&nbsp;WIN32<br> =
= BUILDING&nbsp;UNDER&nbsp;WIN32<br> =


== Installing dev. environment<br> ==
== Installing dev. environment<br> ==


== Installing ext3 fileSystem<br> ==
== Installing ext3 fileSystem<br> ==


== Setting MSVC up<br> ==
== Setting MSVC up<br> ==


== Building<br> ==
== Building<br> ==

Revision as of 18:08, 5 October 2009

This document contains helpful tips for Collabora contractors who have to wrestle with building the Mozilla source under different platforms.

(We can rename the page appropriately, later.)

Collaborans are interested in building E10s on a machine on which Scratchbox is also installed, on which the Maemo SDK can be installed, and on which one can cross-compile to the ARM architecture.

XEN IMAGE

One way to obtain the desired build environment is to obtain a virtual machine image that is properly configured. I (robin_bb) have created such an image. It was current in August 2009.

You can get it here.


In order to use that image, you'll need the Xen virtual machine correctly installed and setup on your box.

MANUAL SETUP

Installing Scratchbox Apophis

NOTE: There are actually two scratchbox versions supported by Nokia, namely Scratchbox 1.0 (Apophis) and Scratchbox2. Both allow electrolysis to build under maemo for ARM processors, but this document will only pertain to version 1.0. See Maemo's scratchbox for harmattan wiki page.

Install from your regular repositories

If you're running DEBIAN or UBUNTU, there's good chances that your distro's repositories keep an up-to-date version of Scratchbox Apophis. If so, install it throught the package manager and all relevant devkits and toolchains suggested in here.

Install manually from files.maemo.org

In any other cases, you can also manually install Scratchbox 1.0.

For that, you need Scratchbox Apophis.



Once you have scratchbox installed, you can clone the mozilla codebase repository.

If you want to build the code for different platforms and different processors, we really recommend that you put the codebase somewhere *UNDER* the /scratchbox directory, because scratchbox console is chroot'ed to the /scratchbox.

Best location is /scratchbox/users/<username>/home/<username>/mozilla/



Note:

The scratchbox '_X86' targets don't add extra value to the build and since your SB build environment might not be as complete  So there's really little need for the XXX_X86 targets in Scratchbox. When you want to build for X86 processors, do it directly from your preferred linux console.

Installing Maemo SDK

As a Collabora developer, you might be targetting a specific maemo platform version.

Pulling the mozilla codebase

Building

Running/Testing your build


Building E10s

BUILDING UNDER WIN32

Installing dev. environment

Installing ext3 fileSystem

Setting MSVC up

Building