667
edits
Changes
no edit summary
[[Dive into Mozilla]] > [[Dive into Mozilla Day 2]] > Makefile Lab
== Overview ==
This lab is designed to give you first-hand experience creating a simple Makefile and using Make to build software. While the Mozilla build system is much more complex than this example, the ideas learned here will get you started understanding how Mozilla is built.
== Instructions ==
The lab machines have already been set-up to use MSVC 8 and MozillaBuild RC1. You only need to run '''Mozilla-Build MSVC 8.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 variables to turn-off assertion dialogs and allow for multiple versions of the browser to be run simultaneously:
##* export XPCOM_DEBUG_BREAK=warn
##* export MOZ_NO_REMOTE=1
## Run the browser as follows:<code>C:\ff\mozilla\objdir\dist\bin\firefox -Profilemanager</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://benjamin.smedbergs.us/blog/2007-01-12/mozillabuild-rc1/ MozillaBuild RC1 for Win32]
* [http://webtools.mozilla.org/build/config.cgi MOZCONFIG Build Configurator]
== Overview ==
This lab is designed to give you first-hand experience creating a simple Makefile and using Make to build software. While the Mozilla build system is much more complex than this example, the ideas learned here will get you started understanding how Mozilla is built.
== Instructions ==
The lab machines have already been set-up to use MSVC 8 and MozillaBuild RC1. You only need to run '''Mozilla-Build MSVC 8.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 variables to turn-off assertion dialogs and allow for multiple versions of the browser to be run simultaneously:
##* export XPCOM_DEBUG_BREAK=warn
##* export MOZ_NO_REMOTE=1
## Run the browser as follows:<code>C:\ff\mozilla\objdir\dist\bin\firefox -Profilemanager</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://benjamin.smedbergs.us/blog/2007-01-12/mozillabuild-rc1/ MozillaBuild RC1 for Win32]
* [http://webtools.mozilla.org/build/config.cgi MOZCONFIG Build Configurator]
