Assignment 1 (yshen6)
Assignment 1 - build firefox
Introduction
In order to build firefox on windows, my first step was search “how to build firefox on Windows” on Google. Then I followed the instructions on David Humphrey's website.
Software Installed
Install the compiler - Visual Studio.NET 2005
Install Cygwin with all packages required for building Mozilla:
ash coreutils cvs diffutils findutils gawk grep libiconv make 3.80 patchutils perl sed unzip zip
Create a directory c:\proj
Download and Extract Moztools to C:\proj\moztools
Steps to Complete the build
Setup environment variables and paths by creating a setup file: c:\proj\buildsetup.bat Copy and paste the given code(from David's website) to c:\proj\buildsetup.bat
@echo off rem --- CVS Setup SET CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot SET CVS_RSH=ssh rem --- Setup the paths to the moztools build libraries set MOZ_TOOLS=C:\proj\moztools set GLIB_PREFIX=%MOZ_TOOLS% set LIBIDL_PREFIX=%MOZ_TOOLS% rem --- Scrub these variables first SET INCLUDE= SET LIB= SET PATH=C:\;C:\windows\system32;C:\windows\system32\wbem rem --- Prepend cygwin SET PATH=C:\cygwin\bin;%PATH% rem --- Setup VC8 compiler environment vars CALL "C:\Program Files\Microsoft Visual Studio 8\VC\vcvarsall.bat" x86 rem --- Add glib/libidl to build environment SET PATH=%PATH%;%GLIB_PREFIX%;%GLIB_PREFIX%\bin SET INCLUDE=%GLIB_PREFIX%\include;%INCLUDE% SET LIB=%GLIB_PREFIX%\lib;%LIB% rem --- moztools comes last after glib/libIDL SET PATH=%PATH%;%MOZ_TOOLS%\bin
Run Cygwin and move into c:\proj directory
Problem1 – I have no idea how to move my current directory to c:\proj in Cygwin
$ cd ../.. $ cd cygdrive/ $ cd c $ cd proj
Setup environment and paths
$ cmd Buildsetup.bat c:\proj> buildsetup.bat
Log into the mozilla CVS by anonymous
Problem2 – failed: connection refused (only at school’s computer)
After handled problem2 run Cygwin again and login CVS by anonymous
C:\proj> cvs login CVS password: anonymous
Checkout the build script:
C:\proj> cvs co mozilla/browser/config mozilla/client.mk Cvs checkout: Updating mozilla/browser/config U mozilla/client.mk
This create some files in C:\proj\mozilla
Move into mozilla directory and create a file .mozconfig
c:\proj\mozilla> touch .mozconfig
open .mozconfig, copy and paste the given code(from David's website).
# Building Firefox Trunk with Debugging . $topsrcdir/browser/config/mozconfig # Put all obj files in one place, not in src tree mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-objdir ac_add_options --disable-static ac_add_options --enable-shared # Debug Build Setup Options ac_add_options --disable-optimize ac_add_options --enable-debug # I'm using Canvas for my work ac_add_options --enable-canvas
now we can get the full source from cvs:
c:\proj\mozilla> make -f client.mk checkout
This will take a little while, then we will see a bunch of files create in c:\proj\mozilla
Now we can build it:
C:\proj\mozilla> make -f client.mk build
After more than half an hour of building, you will find firefox3.0a1 in C:\proj\mozilla\firefox-objdir\dist\bin
Problems
Problem1 - I have no idea how to move my current directory to c:\proj in Cygwin. Mark helped me move the current directory to c:\proj and create the .mozconfig by touch command.
Problem2 - I wasn’t able to log into cvs at school computer. Mark told me to use Putty to tunnel out the school firewall through matix
host Name(or IP address): matix.senecac.on.ca Source Port: 2401 Destination: cvs-mirror.mozilla.org:2401
Login matix
Then Change cvs-mirror.mozilla.org in c:\proj\buildsetup.bat to localhost
Resources
David humphrey’s website
Mark Paruzel
Conclusions
By the instruction on David’s website and mark’s help I build firefox on my first try. But I wasn’t understand clearly about the steps of building it and why it worked that way, at least I didn’t figure out the problem by myself. So I format my hard drive and redo everything by memory and it worked again. All the steps are not too hard to follow, but the building took too long time. Now I am familiar with building firefox on windows.