View source for 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<br/>
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<br/>
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
<pre>
@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

</pre>

Run Cygwin and move into c:\proj directory<br/>
'''Problem1''' – I have no idea how to move my current directory to c:\proj in Cygwin

<pre>
$ cd ../..
$ cd cygdrive/
$ cd c
$ cd proj
</pre>

Setup environment and paths

<pre>
$ cmd Buildsetup.bat
c:\proj> buildsetup.bat
</pre>

Log into the mozilla CVS by anonymous<br/>

'''Problem2''' – failed: connection refused (only at school’s computer)<br/>
After handled problem2 run Cygwin again and login CVS by anonymous

<pre>
C:\proj> cvs login
CVS password: anonymous
</pre>

Checkout the build script:

<pre>
C:\proj> cvs co mozilla/browser/config mozilla/client.mk

Cvs checkout: Updating mozilla/browser/config
U mozilla/client.mk
</pre>

This create some files in C:\proj\mozilla<br/>

Move into mozilla directory and create a file .mozconfig

<pre>
c:\proj\mozilla> touch .mozconfig
</pre>

open .mozconfig, copy and paste the given code(from David's website).

<pre>
# 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

</pre>

now we can get the full source from cvs:

<pre>
c:\proj\mozilla> make -f client.mk checkout
</pre>

This will take a little while, then we will see a bunch of files create in c:\proj\mozilla<br/>

Now we can build it:

<pre>
C:\proj\mozilla> make -f client.mk build
</pre>

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

<pre>
host Name(or IP address): matix.senecac.on.ca
Source Port: 2401
Destination: cvs-mirror.mozilla.org:2401
</pre>

Login matix<br/>
Then Change cvs-mirror.mozilla.org in c:\proj\buildsetup.bat to localhost

== Resources ==
[http://cs.senecac.on.ca/~david.humphrey/writing/firefox-win32-build.html David humphrey’s website]<br/>
[[User:RealMarkP|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.

== Screenshot of the Build Number ==
[[Image:Example.jpg]]