Assignment 1 Building FireFox

Purpose

To boldly go where I have not gone before. In other words build the Firefox application by utilizing the necessary documentation provided by Mozilla and other resources.

Hardware

• Intel Core Duo Processor @ 1.86GHz
• 512 MB of RAM
• 80 gig Samsung Hard Drive

Software

• Windows XP Professional Service Pack 2
• Visual Studio .Net 2003 with Visual C++ included
• Cygwin installed with the following packages
  • ash -- UNIX-like command line interpreter shell (Base category)
  • coreutils -- GNU core utilities (includes fileutils, install, sh-utils, and textutils) (Base category) cvs -- concurrent versions system (Devel category)
  • diffutils -- file comparison utility (Base category)
  • findutils (Base category)
  • gawk -- pattern matching language (Base and Interpretors categories)
  • grep -- text search tool (Base category)
  • libiconv -- character set conversion (Devel category)
  • make 3.80 (not 3.81!) -- dependency analyzer for software builds (Devel category)
  • patchutils -- a small collection of programs that operate on patch files (Devel category)
  • perl -- a scripting language used to control parts of the build (Interpreters category)
  • sed -- a search and replace language (Base category)
  • unzip -- zip file extraction (Archive category)
  • zip -- zip file creation (Archive category)
• moztools
  • package contains binaries and libraries necessary to build mozilla
• CVS
  • source control system used by Mozilla. Downloading the tar balls from Mozilla’s FTP sites can be used also for obtaining the FireFox source code.
• Windows Server 2003 SP1 Platform SDK
• NSIS
• make 3.80 tar package

Steps to Build FireFox

1. Take time to read the Windows Build Prerequsites Web Page [ http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites]
2. Download and installed Windows Server 2003 SP1 Platform SDK
3. Make sure the Visual C++ module for Visual Studio 2003 or 2005 is installed if not download it from the acs.senecac.on.ca website.
4. Install NSIS
5. Install Cygwin(GNU Tools for Microsoft Windows) and download the packages( Please see the for the list
6. Follow the link on the Windows Build Preq and download make-3.80-1.tar.bz2
7. Extract the make.exe from the package and replace the make.exe that came with Cygwin
8. Download and look at the Cygwin.bat file from the Windows Build Prerequsites web page.
   1. Change VCVARS=C:\Program Files\Microsoft Visual Studio 8\VC\bin\vcvars32.bat to point to C:\Program Files\Microsoft Visual Studio .NET 2003\VC7\bin\vcvars32.bat if you are using Visual Studio 2003
   2. Look at the MOZTOOLS variable and where it is pointing to
   3. Install the moztools package in that directory
   4. rename %CYGWINBASE%\bin\link.exe to glink.exe or any other name. This will prevent an error message "incremental linker version does not match the compiler suite version" at compile time.
   5. make the c:\proj folder. This will contain the source and object files that will be generated from the build and the checkout that will be executed later on.
   6. Execute the cygwin batch file (cygwin.bat) using cmd.exe. It successful a cygwin window will open with a prompt.
   7. Once at the prompt check to see that it can access the c:\proj folder. Type c: enter and then cd proj. If this directory
   8. Next type cvs logon
   9. You should see a prompt with your computer name.
   10. Type anonymous as the password.
   11. Before a build the code needs to be checked out to make sure that it has not been damaged in anyway.
   12. At the prompt enter: cvs co mozilla/browser/config mozilla/client.mk

The above step creates a folder called mozilla within the proj director. Navigate to this folder by typing: cd mozilla Create a file named .mozconfig and place it in this c:\proj\mozilla directory. This file contains the settings The contents of the this file can be found within the #.mozconfig File section of the #Appendix. You will notice that the last line of the .mozconfig file disables the installer thus NSIS is not required. If you omit this line then, NSIS (2.17 or greater) must be installed and its install directory (and not the 'bin' directory) added to your path.More information relating to the specifics of this file can be found in the Configuring Build Options section of the Windows build guide made available by the Mozilla Developer Center. Begin source file download by issuing the following command: make -f client.mk checkout To compile the source type make -f client.mk build