Group:IceCat/Compile and package/build 31.2.0 on Debian Wheezy 7.0

{{{master page}}}Property "Master page" (as page type) with input value "{{{master page}}}" contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process. en en

• The information contained in this page is current as of: 3/1/2015.
• The text in this page was last modified on:

4/01/2015.

Introduction

This page contains a report, with comments and hints, on a successful build of Gnuzilla IceCat 31.2.0 on a updated Debian Wheezy amd64 (64bit) machine.

The procedure below might apply, eventually with some differences, also to newer Debian releases and different

Debian ports.

Prepare the developing environment

• System update

First of all, it is highly reccomended having an updated system:

 $ sudo apt-get update
 $ sudo apt-get upgrade

• Install common development tools

The most common development tools should be installed on your system. Please install (this is required only once):

$ sudo apt-get install gcc g++ make patch zip unzip
$ sudo apt-get install autoconf automake build-essential checkinstall 
debhelper devscripts dpkg-dev fakeroot gdb-minimal libc6-dev libtool 
intltool pbuilder pkg-config 

• Install and configure ccache (optional)

If you want to use ccache

during the build process (see below), please install and configure it 

(this is required only once):

$ sudo apt-get install ccache
$ mkdir <ccache_basepath>/ccache
$ export CCACHE_DIR=<ccache_basepath>/ccache
$ ccache --max-size <N>G
$ export CCACHE_COMPRESS=""

where:

<ccache_basepath>: is the

full path of a directory you should choose as base where storing cccache files

<N>: is the

maximum size (in GB) of the cache

Prepare requested libraries and dependencies

To successfully build IceCat you

need some libraries to be installed and some dependencies to be 

satisfied. Please install (this is required only once):

• Linux environment files

$ sudo apt-get install zip mercurial libasound2-dev libcurl4-openssl-dev
 libnotify-dev libxt-dev libiw-dev libidl-dev mesa-common-dev 
autoconf2.13 yasm libgtk2.0-dev libdbus-1-dev libdbus-glib-1-dev 
python-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev 
libpulse-dev

(see: [https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Linux_Prerequisites/

Linux_Prerequisites] at the [https://developer.mozilla.org/en-US/ 

Mozilla Developer Network])

• Default IceCat libraries

$ sudo apt-get install libpango libpangoxft libpangoft2 libfreetype 
libxft libgtk2 libx11

(see: 'README.IceCat' file contained in the [http://ftp.gnu.org/gnu/gnuzilla/31.2.0/icecat-31.2.0.tar.xz IceCat 31.2.0 sources])

• Other suggested libraries and dependencies

$ sudo apt-get install libxml2-dev libglib2.0-dev libevent-dev libiw-dev
 libglu1-mesa-dev xulrunner-dev python python-virtualenv python-pip
$ sudo apt-get install build-dep iceweasel

Prepare the building environment

IMPORTANT NOTE: Every time the build process fails, it is highly recommended to repeat all the entire process, starting again from a completely clean building environment (see here below): cleaned and cleared ccache, empty src and obj directories etc. A system reboot is also suggested.

The building environment should be set up before to start the building process. Please do the following:

• Clean and check ccache

If ccache is in use, it should be clear and clean:

$ ccache --clear --cleanup
$ ccache -s

• Set the building base directory

You should have a directory to use as base for all the building process:

$ cd <build_basepath>
$ mkdir icecat-31.2.0
$ cd icecat-31.2.0

where:

<build_basepath>:

is the path of a directory you should choose as base for all the 

building process

icecat-31.2.0: is the

sub-directory of <build_basepath> where to work

• Download the sources

To download the sources into the <build_basepath>/icecat-31.2.0

directory, please run:

$ curl -O -J -L 
'https://ftp.gnu.org/gnu/gnuzilla/31.2.0/icecat-31.2.0.tar.xz' 
$ curl -O -J -L 
'https://ftp.gnu.org/gnu/gnuzilla/31.2.0/icecat-31.2.0.tar.xz.sig' 

• Verify the downloaded sources

The Gnuzilla IceCat releases are

signed with a gpg key. The new gpg key has ID:D7E04784. 

Please download the key and check its fingerprint:

$ gpg --keyserver keys.gnupg.net --recv-keys D7E04784
$ gpg --fingerprint D7E04784

The fingerprint of the gpg key used to sing the Gnuzilla IceCat releases should be:

A573 69A8 BABC 2542 B5A0  368C 3C76 EED7 D7E0 4784

Then verify the downloaded sources:

$ gpg --verify icecat-31.2.0.tar.xz.sig 

• Prepare the sources

To prepare the sources tree in the <build_basepath>/icecat-31.2.0/src

directory, please run:

$ tar -Jxvf icecat-31.2.0.tar.xz
$ mv icecat-31.2.0  src

Configure the build

Configuration of the build process could be obtained through:

configuration parameters

which can be passed to the command script configure as command-line

parameters or, better, through a configuration file named src/.mozconfig (or src/mozconfig) to be created into the source directory

configuration variables

which can be set via the src/browser/confvars.sh file

The configuration parameters are used by the command script configure to set the corresponding configuration variables.

Please note that *not* all the configuration variables can be set through the command script configure: these variables can be set only directly in the src/browser/confvars.sh file.

Set the configuration parameters (file: src/mozconfig)

The best way to set any of the configuration parameters is through a configuration file src/.mozconfig (or src/mozconfig) to be created into the source directory.

A complete list of the available parameters can be obtained running:

$ ./src/configure --help

Here below is listed the content of the src/mozconfig which is suggested

to be used building [https://ftp.gnu.org/gnu/gnuzilla/31.2.0/ IceCat 

31.2.0].

Use your favourite text editor to create and modify it if necessary.

Please note that:

• this file has been tested since has been successfully used building

IceCat 31.2.0

• before to start the build process is *highly reccomended* to check

carefully all the content of this file, in order to comment/uncomment

the options accordingly with your system and your preferences

###
### - icecat mozconfig file - debian wheezy amd64
###

### - the following two are from: 'build/mozconfig.common' (should not 
be changed)
### - WARNING: THE FOLLOWING TWO SHOULD NOT BE CHANGED

mk_add_options AUTOCLOBBER=1
ac_add_options --enable-release

### - app & paths  (should not be changed)
### - WARNING: THE FOLLOWING SHOULD NOT BE CHANGED

# application to build
ac_add_options --enable-application=browser

# path: sources for locales
ac_add_options --with-l10n-base=$topsrcdir/l10n

# build using an objdir (to keep sources clean)
mk_add_options MOZ_OBJDIR=$topsrcdir/../obj

# path: system install dir
ac_add_options --prefix=/usr

### - ccache (comment out if you do not use ccache!!!)
### - WARNING: THE FOLLOWING ONE SHOULD BE COMMENT OUT IF NOT USING 
CCACHE

# build using ccache 
ac_add_options --with-ccache

### - building...  (should not be changed)
### - WARNING: THE FOLLOWING SHOULD NOT BE CHANGED

# build with optimization
ac_add_options --enable-optimize="-pipe -O3"

# elf-hack
ac_add_options --enable-elf-hack

# avoid dependency on libstdc++ 4.7
ac_add_options --enable-stdcxx-compat

# stripping
ac_add_options --enable-strip
ac_add_options --enable-install-strip

### - app options  (should not be changed)
### - WARNING: THE FOLLOWING SHOULD NOT BE CHANGED

# branding
ac_add_options --enable-official-branding
ac_add_options --with-distribution-id=org.gnu 

# enable wanted options
ac_add_options --enable-safe-browsing 
ac_add_options --enable-gio 
ac_add_options --disable-gnomevfs 
ac_add_options --enable-gstreamer=0.10 
ac_add_options --enable-default-toolkit=cairo-gtk2

# disable unwanted options
ac_add_options --disable-debug
ac_add_options --disable-debug-symbols
ac_add_options --disable-tests 
ac_add_options --disable-crashreporter 
ac_add_options --disable-updater 
ac_add_options --disable-update-channel
ac_add_options --disable-update-packaging
ac_add_options --disable-maintenance-service
ac_add_options --disable-parental-controls 
ac_add_options --disable-webapp-runtime
ac_add_options --disable-necko-wifi 

### - other recommended options (comment out what you do not want/need)

# webm (VP8 video and Vorbis audio) support 
# WARNING: VP8 and Vorbis must be installed in your system!
ac_add_options --enable-webm 

# use alsa instead of pulseaudio
# WARNING: Alsa must be installed in your system!
# WARNING: comment/uncomment TOGETHER the following two
ac_add_options --enable-alsa  
ac_add_options --disable-pulseaudio 

# wave support
ac_add_options --enable-wave 

### - to be tested (uncomment the options you want to use)
### - WARNING: THE FOLLOWING NOT TESTED!!! USE WITH CARE: THE BUILD 
MIGHT FAIL!!!

# ac_add_options --with-system-zlib 
# ac_add_options --with-system-bz2 
# ac_add_options --enable-system-hunspell 

# ac_add_options --with-system-libxul
# ac_add_options --with-system-libvpx
# ac_add_options --enable-system-pixmap

# ac_add_options --enable-canvas
# ac_add_options --enable-raw
# ac_add_options --enable-xinerama


### - DO NOT WORK WITH DEBIAN WHEEZY (should not be changed) - Maybe 
they work with newer Debian releases
### - WARNING: AVOID USING THE FOLLOWING WITH DEBIAN WHEEZY!!! THE BUILD
 WILL PROBABLY FAIL!!!

# NSPR too old
# ac_add_options --with-system-nspr 

# system's libpng doesn't have APNG support
# ac_add_options --with-system-png 

# SQLITE too old (should be sqlite3 >= 3.8.4.2)
# ac_add_options --enable-system-sqlite 

# error: Insufficient JPEG library version for --with-system-jpeg
# ac_add_options --with-system-jpeg 
# ac_add_options --disable-libjpeg_turbo

# error NSS wrong version (should be >= 3.16.2.2)
# ac_add_options --with-system-nss 

Set the configuration variables (file: src/browser/confvars.sh)

The variables which can not be set through the command script configure, can be set directly in the src/browser/confvars.sh file.

Use your favourite text editor to modify it if necessary.

Please note that:

• a very deep knowledge and comprehension of the source code is needed

to safely modify this file

• the documentation about these variables is often poor and/or unclear
• is *highly reccomended* to avoid changes in this file if

unnecessary

Here below are listed some variables which can be safely add at the bottom of the src/browser/confvars.sh file, being tested to produce a successful build of IceCat 31.2.0:

# ## 
# ## src/browser/confvars.sh CUSTOM SETTINGS 
# ## 
# ## ADD THIS AT THE BOTTOM OF 'src/browser/confvars.sh'

MOZ_SERVICES_METRICS=

MOZ_SOCIAL=
MOZ_DATA_REPORTING=
MOZ_TELEMETRY_REPORTING=
MOZ_SERVICES_HEALTHREPORT=
MOZ_CRASHREPORTER=

Build IceCat 31.2.0

Building the binaries means run configure and make. It 'a heavy task, requiring significant system resources and can last for a very long time. On a machine with 64bit CPU 4-core 3.8GHz and 8GB RAM, it takes about 40-45 minutes.

• Prepare the directory <build_basepath>/icecat-31.2.0/obj

where to build

The build will take place in a separate so-called objdir sub-directory (whose path

has been previously set in the src/mozconfig file), in order to
leave clean the sources tree.:

$ mkdir obj
$ cd obj

• Run configure

Staying in the <build_basepath>/icecat-31.2.0/obj

directory, please run:

$ ../src/configure

or, if you want to capture and save the output of the command to the terminal:

$ ../src/configure 2>&1 | tee config.txtout

The command script log will be in the config.log file.

The command script output to the terminal will be (if saved as above using tee) in the config.txtfile file.

• Run make

Staying in the <build_basepath>/icecat-31.2.0/obj

directory, please run:

$ make -j<N> -f ../src/client.mk 2>&1 | tee make.txtout

or, if you want to capture and save the output of the command to the terminal:

$ make -j<N> -f ../src/client.mk 2>&1 | tee make.txtout

where:

<N>: is the

number of the CPU cores/threads you want to be used during the compilation

The command script output to the terminal will be (if saved as above using tee) in the make.txtfile file.

• Langpack (optional)

You can simply download the pre-built [https://ftp.gnu.org/gnu/gnuzilla/31.2.0/langpacks/ langpacks for IceCat 31.2.0] you need.

Otherwise, if you prefer to build yourself a langpack, please run:

$ cd browser/locales
$ make langpack-$LANG LOCALE_MERGEDIR=.
$ cd ../..

where:

$LANG: is the locale of

the langpack to build

Installation

After the building process has been successfully completed, you might want to install IceCat on your system.

Standalone installation

To install the binaries as a "standalone" program, staying in the <build_basepath>/icecat-31.2.0/obj

directory, please run:

$ make install DESTDIR=<build_basepath>/icecat-31.2.0/bin

where:

<build_basepath>:

is the path of a directory you should choose as base for all the 

building process (please, now use a *full* path here)

The "standalone" binaries will be generated into the <build_basepath>/icecat-31.2.0/bin/usr/lib/icecat-31.2.0

directory.

To install just copy the directory with the "standalone" binaries in an appropriate place to be used in your system. A common suggested place is

/opt/icecat.

Tarball package creation

To create a binary tarball, staying in the <build_basepath>/icecat-31.2.0/obj

directory, please run:

$ cd browser/installer
$ make
$ cd ../..

The tarball package will be generated into the <build_basepath>/icecat-31.2.0/obj/dist

directory.

Enjoy Gnuzilla IceCat!

---

[ Document edited by: alexus ]