Collabora Notes

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.

Install from 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.

Install manually

In any cases, you can also manually install Scratchbox 1.0. In order to build firefox, fennec or 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.

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.