View source for Real World Mozilla Build Mozilla Lab

[[Real World Mozilla]] > [[Real World Mozilla Day 2]] > Build Mozilla Lab

== Overview ==

This lab is designed to give you first-hand experience building Mozilla from source code.  This includes setting-up a proper development/build environment, using CVS to obtain the code, configuring your build, and actually doing a complete build.

By the end of this lab you should have a functioning debug trunk build of Firefox, which we'll use for the remainder of the week for our other development work.

== Instructions ==

In order to build Mozilla from source you must create a build environment, incluidng [http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-1.1.exe Mozilla Build (1.1 or newer)] and MSVC 8.  Once both of these have been installed (they should already be in the lab), you only need to run '''start-msvc8.bat''' (there is a link on the desktop) to begin (i.e., you shouldn't need to install anything).

# Create a directory called '''C:\ff''' to hold the source
# Make sure the tree is '''not red''' on [http://tinderbox.mozilla.org/showbuilds.cgi?tree=Firefox tinderbox]
# Check-out the Firefox code from '''CVS''' into C:\ff ([http://developer.mozilla.org/en/docs/Mozilla_Source_Code_%28CVS%29 instructions are here]).  You can use either of the following CVSROOT values:
#* :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
#* :pserver:anonymous@hera.senecac.on.ca:/cvsroot
# Create a '''.mozconfig''' file ([http://developer.mozilla.org/en/docs/Configuring_Build_Options instructions are here]) in '''C:\ff\mozilla''' with the following:
#* Use an Object Directory (OBJDIR) named '''objdir'''
#* '''Disable''' Optimization
#* '''Enable''' Debugging
#* Use '''Shared''' libraries instead of Static
# Build the source ([http://developer.mozilla.org/en/docs/Build_and_Install instructions are here])
# wait, wait, wait...NOTE: the build process (a debug build) takes approximately '''1 hour''' to complete in the lab.
# Test your new browser:
## Set the following environment variable to turn-off assertion dialogs, and run Firefox as follows (NOTE: -no-remote allows for another version of the browser to be run at the same time, and -Profilemanager allows you to choose/create a new profile so you don't corrupt your default profile):
##* export XPCOM_DEBUG_BREAK=warn
## Run the browser as follows:<br /><code>C:\ff\mozilla\objdir\dist\bin\firefox -Profilemanager -no-remote</code>
## When prompted, create a new profile called '''development'''
## In the address bar, enter the following URI and note the build information: '''about:'''

== Resources ==
* [http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-1.1.exe MozillaBuild 1.1 for Win32] 
* [http://webtools.mozilla.org/build/config.cgi MOZCONFIG Build Configurator]