XULRunner
Contents
Introduction to XULRunner
XULRunner is a Mozilla runtime package that can be used to bootstrap XUL+XPCOM applications that are as rich as Firefox and Thunderbird. It will provide mechanisms for installing, upgrading, and uninstalling these applications. XULRunner will also provide libxul, a solution which allows the embedding of Mozilla technologies in other projects and products.
Project Homepage: https://developer.mozilla.org/en/XULRunner
Dependencies
Required
Recommended
Optional
Creating a .mozconfig
The .mozconfig file contains the options that will be used to build firefox.
The first line includes the default configuration for compiling and the second line determines where the build objects are going to reside.
Having --with-system-nss and --with-system-nspr does not mean you *HAVE* to have a system installed version of nss and nspr. It makes the build system prefer to use the system installed version of nss and nspr over the internal version.
--enable-canvas enables support for the <canvas></canvas> tag.
--enable-svg enables support for rendering svg files.
--disable-tests prevents test programs from being built which saves a lot of disk space and time.
--disable-installer prevents the installer from being built.
cat > .mozconfig << "EOF" . $topsrcdir/xulrunner/config/mozconfig mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/obj-@CONFIG_GUESS@ ac_add_options --prefix=/opt/xulrunner-1.9.1.16 ac_cv_visibility_pragma=no ac_add_options --with-nspr-prefix=/usr ac_add_options --with-nss-prefix=/usr ac_add_options --with-system-nspr ac_add_options --with-system-nss ac_add_options --with-system-bz2 ac_add_options --with-system-jpeg ac_add_options --with-system-png ac_add_options --with-system-zlib ac_add_options --disable-debug ac_add_options --disable-installer ac_add_options --disable-xprint ac_add_options --disable-tests ac_add_options --enable-canvas ac_add_options --enable-default-toolkit=cairo-gtk2 ac_add_options --enable-safe-browsing ac_add_options --enable-svg ac_add_options --enable-system-cairo ac_add_options --enable-system-sqlite EOF
If you would like dual monitor support, append your your .mozconfig with the following:
cat >> .mozconfig << "EOF" ac_add_options --enable-xinerama EOF
If you would like to render fonts with Pango, append your your .mozconfig with the following. This can significantly slow font rendering.
cat >> .mozconfig << "EOF" ac_add_options --enable-pango EOF
If you do not have JDK installed then add the following to your .mozconfig:
cat >> .mozconfig << "EOF" ac_add_options --disable-javaxpcom EOF
Non-Multilib
If you're using a system wide installation of NSS and NSPR then apply the following patch so that their headers can be found properly:
patch -Np1 -i ../xulrunner-1.9.1.16-system_nss-1.patch
Compile the package:
make -f client.mk build
Install the package:
make -f client.mk install
50-xulrunner.sh
If you're using the Bash Startup Files create an addition for firefox with the following commands, otherwise make sure the enviornment variables are set in your profile:
cat > /etc/profile.d/50-xulrunner.sh << "EOF"
# Begin /etc/profile.d/50-xulrunner.sh
export PATH="${PATH}:/opt/xulrunner-1.9.1.16/bin"
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}${PKG_CONFIG_PATH+:}/opt/xulrunner-1.9.1.16/lib/pkgconfig"
# End /etc/profile.d/50-xulrunner.sh
EOF
Multilib
32Bit
If you're using a system wide installation of NSS and NSPR then apply the following patch so that their headers can be found properly:
patch -Np1 -i ../xulrunner-1.9.1.16-system_nss-1.patch
Use the following command to append your .mozconfig with 32bit specific flags:
cat >> .mozconfig << EOF
export CC="gcc ${BUILD32}"
export CXX="g++ ${BUILD32}"
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH32}"
export USE_ARCH=32
ac_add_options --host=$CLFS_TARGET32
ac_add_options --build=$CLFS_TARGET32
mk_add_options CONFIG_GUESS=$CLFS_TARGET32
EOF
x86
Compile the package:
make -f client.mk OS_TEST=x86 build
Install the package:
make -f client.mk OS_TEST=x86 install
ppc64
Compile the package:
make -f client.mk OS_TEST=powerpc build
Install the package:
make -f client.mk OS_TEST=ppc install
64Bit
If you're using a system wide installation of NSS and NSPR then apply the following patch so that their headers can be found properly:
patch -Np1 -i ../xulrunner-1.9.1.16-system_nss-1.patch
Use the following command to append your .mozconfig with 64bit specific flags:
cat >> .mozconfig << EOF
ac_add_options --libdir=/opt/xulrunner-1.9.1.16/lib64
export CC="gcc ${BUILD64}"
export CXX="g++ ${BUILD64}"
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH64}"
export USE_ARCH=64
EOF
Compile the package:
make -f client.mk build
Install the package:
50-xulrunner.sh
If you're using the Bash Startup Files create an addition for firefox with the following commands, otherwise make sure the enviornment variables are set in your profile:
cat > /etc/profile.d/50-xulrunner.sh << "EOF"
# Begin /etc/profile.d/50-xulrunner.sh
export PATH="${PATH}:/opt/xulrunner-1.9.1.16/bin"
export PKG_CONFIG_PATH32="${PKG_CONFIG_PATH32}${PKG_CONFIG_PATH32+:}/opt/xulrunner-1.9.1.16/lib/pkgconfig"
export PKG_CONFIG_PATHN32="${PKG_CONFIG_PATHN32}${PKG_CONFIG_PATHN32+:}/opt/xulrunner-1.9.1.16/lib32/pkgconfig"
export PKG_CONFIG_PATH64="${PKG_CONFIG_PATH64}${PKG_CONFIG_PATH64+:}/opt/xulrunner-1.9.1.16/lib64/pkgconfig"
# End /etc/profile.d/50-xulrunner.sh
EOF
