Developer:Building Spicebird From Source Code

From Spicebird

Jump to: navigation, search

This page describes the steps required to build Spicebird from Source Code.

1 Build Prerequisites
2 Get and Prepare the Source Code
3 Build the Source Code
4 Creating installer
5 Related Links

[edit] Build Prerequisites

Spicebird has the same prerequisites as Mozilla Firefox and Mozilla Thunderbird described at

http://developer.mozilla.org/en/docs/Build_Documentation#Build_prerequisites.

[edit] Get and Prepare the Source Code

Get the Spicebird source code as described in Developer:Get Spicebird Source Code page. You will most likely end up having a tarball or a folder with Spicebird source when checked out from the Subversion repository.
If you ended up downloading a tarball, extract it.
```
$ tar -xvjf spicebird-beta-0.4.source.tar.bz2 
```
This would create a folder named 'collab'.
Download the compatible Mozilla source code as described in Developer:Get Compatible Mozilla Source Code page. You will end up having a source tarball or a folder if you checked out the source from Mozilla CVS.
Again, if you ended up downloading a tarball, extract it.
```
$ tar -xvjf mozilla_DATE_20071122_0000_PDT.tar.bz2 
```
This will create a folder named 'mozilla' - which is the Mozilla source directory. Move the extracted Spicebird code (from step 2) to the Mozilla source directory.
```
$ mv /path/to/collab /path/to/mozilla
```
Spicebird sometimes needs a few changes (that have not gone upstream, yet) in the base Mozilla code. For this patches are provided along with the collab source code. Apply these patches.
```
$ cd /path/to/mozilla
$ collab/patches/patch.sh
```
Note: Older version of the Spicebird has patches distributed separately. In this case you need to download the patches tarball, listed in the table on Developer:Get Compatible Mozilla Source Code page and apply them similarly.

[edit] Build the Source Code

Create mozconfig

$ echo ". ${topsrcdir}/collab/config/mozconfig" > $HOME/.mozconfig

Start compilation

$ cd /path/to/mozilla/source 
$ make -f client.mk build

[edit] Creating installer

To create an installer, the following line has be to included in mozconfig file, before the compilation is started.

$ echo "ac_add_options --enable-static --disable-shared" > $HOME/.mozconfig

NOTE: Unless MOZ_OBJDIR is specified, build directory is same as the Mozilla source directory.

After the compilation is done, change to the build directory and build the installer.

$ cd /path/to/build-dir
$ make -C collab/installer installer

On Linux, this will create a bzipped file at /path/to/build-dir/dist and on Windows, this will create a setup file at /path/to/build-dir/dist/install/sea.