Firefox-12.0

Introduction to Firefox

Firefox is a stand-alone browser based on the Mozilla codebase.

This package is known to build and work properly using an LFS-7.1 platform.

Package Information

Firefox Dependencies

Required

alsa-lib-1.0.25, gtk+-2.24.10, Zip-3.0, and UnZip-6.0.

Recommended

Optional

D-Bus GLib Bindings-0.98, startup-notification-0.12, SQLite-3.7.11, Hunspell, Libevent, Doxygen-1.7.5, gnome-vfs-2.24.4 and libgnomeui-2.24.5 (for integration with the old version of Gnome), libnotify-0.7.5, NSPR-4.9, NSS-3.13.4, Wireless Tools-29, Valgrind (only for testing the jemalloc code), Wget-1.13.4, and Xulrunner-12.0

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/firefox

Installation of Firefox

There are two major methods for building Firefox. In the standard case, the entire suite of libraries is built and installed. In the other, most of the system is built using the procedures found in Xulrunner-12.0. This is advantageous if you are planning to build other related packages such as IcedTea-Web-1.2. With either build method, you need to run the main build procedure below with the appropriate options in the mozconfig file. Then use the appropriate instructions depending on the chosen build method.

The configuration of Firefox is accomplished by creating a mozconfig file containing the desired configuration options. A default mozconfig is created below. To see the entire list of available configuration options (and an abbreviated description of each one), issue ./configure --help. You may also wish to review the entire file and uncomment any other desired options. Create the file by issuing the following command:

cat > mozconfig << "EOF"
# If you have a multicore machine you can speed up the build by running
# several jobs at once, but if you have a single core, delete this line:
mk_add_options MOZ_MAKE_FLAGS="-j4"

# If you have installed Yasm delete this option:
ac_add_options --disable-webm

# If you have installed DBus-Glib delete this option:
ac_add_options --disable-dbus

# If you have installed wireless-tools delete this option:
ac_add_options --disable-necko-wifi

# If you have installed libnotify delete this option:
ac_add_options --disable-libnotify

# If you have installed xulrunner uncomment these two lines:
# ac_add_options --with-system-libxul
# ac_add_options --with-libxul-sdk=/usr/lib/xulrunner-devel-12.0

# Uncomment these if you have installed them:
# ac_add_options --enable-startup-notification
# ac_add_options --enable-system-hunspell
# ac_add_options --enable-system-sqlite
# ac_add_options --with-system-libevent
# ac_add_options --with-system-libvpx
# ac_add_options --with-system-nspr
# ac_add_options --with-system-nss

mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir
ac_add_options --enable-official-branding
ac_add_options --prefix=/usr

# The rest of these options have no effect if you're
# building against an already installed xulrunner:
ac_add_options --disable-crashreporter
ac_add_options --disable-debug
ac_add_options --disable-installer
ac_add_options --disable-static
ac_add_options --disable-tests
ac_add_options --disable-updater
ac_add_options --enable-shared
ac_add_options --enable-system-cairo
ac_add_options --enable-system-ffi
ac_add_options --with-pthreads
ac_add_options --with-system-jpeg
ac_add_options --with-system-png
ac_add_options --with-system-zlib
EOF

Compile Firefox by issuing the following commands:

sed -i '/fcntl.h/a#include <unistd.h>' \
  ipc/chromium/src/base/{file_util_linux,message_pump_libevent}.cc &&
sed -i '/sys\/time\.h/a#include <unistd.h>' ipc/chromium/src/base/time_posix.cc &&
sed -i 's# ""##' browser/base/Makefile.in &&
make -f client.mk

This package does not come with a test suite.

If you have not linked Firefox against an installed Xulrunner:

make -C firefox-build-dir/browser/installer

Now, as the root user, if you have not linked Firefox against an installed Xulrunner, install the package:

rm -rf /usr/lib/firefox-12.0 &&
mkdir /usr/lib/firefox-12.0 &&
tar -xvf firefox-build-dir/dist/firefox-12.0.en-US.linux-$(uname -m).tar.bz2 \
  -C /usr/lib/firefox-12.0 --strip-components=1 &&
ln -sfv ../lib/firefox-12.0/firefox /usr/bin &&
mkdir -p /usr/lib/mozilla/plugins &&
ln -sv ../mozilla/plugins /usr/lib/firefox-12.0 &&
chown -R -v root:root /usr/lib/firefox-12.0

If you have linked against an already installed Xulrunner, as the root user:

make -C firefox-build-dir install &&
rm /usr/bin/firefox &&
cat > /usr/bin/firefox << "HERE_DOC" &&
#!/bin/bash
/usr/lib/xulrunner-12.0/xulrunner /usr/lib/firefox-12.0/application.ini "${@}"
HERE_DOC
chmod 755 /usr/bin/firefox &&
mkdir -p /usr/lib/mozilla/plugins &&
ln -sv ../mozilla/plugins /usr/lib/firefox-12.0

NPAPI Headers

The above instructions just install the parts you need to run Firefox. If you want to compile gnash-0.8.10, the open source version of Flash, copy some headers that Gnash needs into /usr/include, as the root user:

mkdir /usr/include/npapi
cp dom/plugins/base/*.h /usr/include/npapi

Command Explanations

sed -i '/fcntl.h/a#include <unistd.h>' ipc/chromium/src/base/{file_util_linux,message_pump_libevent}.cc && sed -i '/sys\/time\.h/a#include <unistd.h>' ipc/chromium/src/base/time_posix.cc: These seds fix bugs that would otherwise break the build if you're using GCC 4.7.

sed -i 's# ""##' browser/base/Makefile.in: This sed removes an unprintable control character from the title bar.

make -f client.mk ...: Mozilla products are packaged to allow the use of a configuration file which can be used to pass the configuration settings to the configure command. make uses the client.mk file to get initial configuration and setup parameters.

make -C firefox-build-dir/browser/installer: this creates a Firefox tarball similar to the ones you can download from Mozilla.

tar -xfv firefox-build-dir/dist ...: This untars Firefox in /usr/lib. The --strip-components=1 option removes the leading 'firefox' directory from the filenames, allowing us to untar it into a versioned directory.

make -C firefox-build-dir install: This runs make install in firefox-build-dir.

ln -sfv ... /usr/bin/firefox: this puts a symbolic link to the firefox executable in your ${PATH}.

mkdir -p /usr/lib/mozilla/plugins: this checks that /usr/lib/mozilla/plugins exists.

ln -sv ... /usr/lib/firefox-12.0: this makes a symbolic link to /usr/lib/mozilla/plugins. It's not really needed, Firefox checks /usr/lib/mozilla/plugins by default, we make the symbolic link to keep all the plugins installed in one folder.

Configuring Firefox

If you deleted the --disable-webm option from your mozconfig, your Firefox can play most YouTube videos without the need for the flash plugin. To enable this, go to http://www.youtube.com/html5 and click on 'Join the HTML5 Trial' (needs cookies enabled).

If you use a desktop environment like Gnome or KDE you may like to create a firefox.desktop file so that Firefox appears in the panel's menus. If you didn't enable startup-notification in your mozconfig change the StartupNotify line to false. As the root user:

mkdir -p /usr/share/applications &&
cat > /usr/share/applications/firefox.desktop << "EOF" &&
[Desktop Entry]
Encoding=UTF-8
Type=Application
Name=Firefox
Comment=Browse The Web
Icon=firefox
Exec=firefox
Categories=Network;GTK;Application;Browser;WebBrowser;
StartupNotify=true
Terminal=false
EOF
ln -sv -f /usr/lib/firefox-12.0/icons/mozicon128.png /usr/share/pixmaps/firefox.png

Contents

Installed Programs: firefox
Installed Libraries: Numerous libraries, browser components, plugins, extensions, and helper modules installed in /usr/lib/firefox-12.0.
Installed Directories: /usr/include/npapi and /usr/lib/firefox-12.0.

Short Descriptions

firefox

is a Gtk 2 internet browser that uses the Gecko rendering engine.

Last updated on 2012-05-19 22:21:51 +0000