Simple Firefox build

  • Revision slug: Simple_Firefox_build
  • Revision title: Simple Firefox build
  • Revision id: 17991
  • Created:
  • Creator: Jorend
  • Is current revision? No
  • Comment 91 words added, 55 words removed

Revision Content

You can build a bleeding-edge, development version of Firefox using the commands below. For complete information, see the build documentation.

Installing build tools

If your system is not listed below, see the build prerequisites page.

Ubuntu Linux:
sudo apt-get build-dep firefox
sudo apt-get install mercurial libasound2-dev libcurl4-openssl-dev
Fedora Linux:
sudo yum groupinstall 'Development Tools' 'Development Libraries' 'GNOME Software Development'
sudo yum install mercurial autoconf213
Mac:
  • Install Xcode Tools. Insert "Mac OS X Install Disc 2", then open XcodeTools.mpkg. (For some Mac OS X versions, you will find it in a directory called "Optional Installs".)
  • Install MacPorts.
  • Run these commands to install the other build tools:
    sudo port sync
    sudo port install mercurial libidl autoconf213
    

Problems? See Mac OS X build prerequisites.

Windows:

Problems? See Windows build prerequisites.

 

Building Firefox

Building Firefox requires at least 1 GB of disk space, 500 MB of RAM, and lots of available swap space.

# Get the source
hg clone http://hg.mozilla.org/mozilla-central/
cd mozilla-central

# 
echo '. $topsrcdir/browser/config/mozconfig' > mozconfig
echo 'mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir
echo 'mk_add_options MOZ_MAKE_FLAGS="-s -j4"' >> mozconfig # use -' >> mozconfig

# Build
make -f client.mk
  • For a debug build, you need different configuration options in your mozconfig file.  This requires more disk space, about 2.5 GB.
    . $topsrcdir/browser/config/mozconfig
    mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir-ff-debug
    ac_add_options --enable-debug
    ac_add_options --disable-optimize
    ac_add_options --enable-tests
  • To build Thunderbird or SeaMonkey, you'll need more source code and some changes to your mozconfig file.
  • On Windows, the above commands will create the mozilla-central directory in %USERPROFILE% which will likely be some subfolder of c:\Documents and Settings.  The space in this directory name will cause the configure script to break.  To (possibly) fix this, do "cd /c:" before the "hg clone" command above.
  • The firefox executable can be found in objdir-ff-release/dist/bin/ (on Mac, objdir-ff-release/dist/Minefield.app/Contents/MacOS/).

 

How to build again later

In your mozilla-central directory, run these commands:

# Get the latest source
hg pull -r default
hg update

Then just re-run the Configure and Build commands above. make will only recompile files that changed, but it's still a long haul. An incremental build can be faster.

You must use the same configure options each time you rebuild.  To avoid this error-prone step, use a mozconfig file.

 

Revision Source

<p>You can build a bleeding-edge, development version of Firefox using the commands below. For complete information, see the <a class="internal" href="/en/Build_Documentation" title="En/Build Documentation">build documentation</a>.</p>
<h2>Installing build tools</h2>
<p>If your system is not listed below, see the <a class="internal" href="/en/Build_Documentation#Build_prerequisites" title="En/Build Documentation#Build prerequisites">build prerequisites page</a>.</p>
<table style="margin-left: 2.5em;"> <tbody> <tr> <td style="vertical-align: baseline;">Ubuntu Linux:</td> <td> <pre>sudo apt-get build-dep firefox
sudo apt-get install mercurial libasound2-dev libcurl4-openssl-dev
</pre> </td> </tr> <tr> <td style="vertical-align: baseline;">Fedora Linux:</td> <td> <pre>sudo yum groupinstall 'Development Tools' 'Development Libraries' 'GNOME Software Development'
sudo yum install mercurial autoconf213
</pre> </td> </tr> <tr> <td style="vertical-align: baseline;">Mac:</td> <td> <ul> <li>Install Xcode Tools. Insert "Mac OS X Install Disc 2", then open <code>XcodeTools.mpkg</code>. (For some Mac OS X versions, you will find it in a directory called "Optional Installs".)</li> <li>Install <a class="external" href="http://www.macports.org/install.php">MacPorts</a>.</li> <li>Run these commands to install the other build tools: <pre class="eval">sudo port sync
sudo port install mercurial libidl autoconf213
</pre> </li> </ul> <p>Problems? See <a class="internal" href="/en/Mac_OS_X_Build_Prerequisites" title="en/Mac_OS_X_Build_Prerequisites">Mac OS X build prerequisites</a>.</p> </td> </tr> <tr> <td style="vertical-align: baseline;">Windows:</td> <td> <ul> <li>Building on Windows Vista 64-bit (and maybe XP 64-bit) <a class="external" href="http://groups.google.com/group/mozilla.dev.builds/browse_thread/thread/c4e51eac5d2a26d5/a7e09f32ecbfc7ad?lnk=gst&amp;q=vista+64" title="http://groups.google.com/group/mozilla.dev.builds/browse_thread/thread/c4e51eac5d2a26d5/a7e09f32ecbfc7ad?lnk=gst&amp;q=vista+64">does not seem to be supported</a>.</li> <li>If you're using Windows XP, you must have <a class="external" href="http://www.microsoft.com/windowsxp/sp2/default.mspx">Windows XP Service Pack 2</a> and <a class="external" href="http://www.microsoft.com/downloads/info.aspx?na=47&amp;p=3&amp;SrcDisplayLang=en&amp;SrcCategoryId=&amp;SrcFamilyId=4377f86d-c913-4b5c-b87e-ef72e5b4e065&amp;u=details.aspx%3ffamilyid%3d0856EACB-4362-4B0D-8EDD-AAB15C5E04F5%26displaylang%3den">.NET Framework 2.0</a>.</li> <li>Install <a class="external" href="http://msdn2.microsoft.com/en-us/vstudio/aa700736.aspx" title="http://msdn2.microsoft.com/en-us/vstudio/aa700736.aspx">Visual Studio</a>.  The express version will work.</li> <li>Install the <a class="external" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=4377f86d-c913-4b5c-b87e-ef72e5b4e065&amp;DisplayLang=en">Microsoft Windows SDK Update for Windows Vista</a> (even if you don't use Vista).</li> <li>Install the <a class="external" href="http://www.microsoft.com/downloads/details.aspx?familyid=0baf2b35-c656-4969-ace8-e4c0c0716adb&amp;displaylang=en">Microsoft Windows Server 2003 R2 Platform SDK</a>. You need at least the "Windows Core SDK", "Web Workshop (IE) SDK", and the "Data Access Services (MDAC) SDK".</li> <li>Install <a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-1.3.exe">MozillaBuild</a>, a package of additional build tools. (If you get a message saying this application did not install properly then you should see a windows dialog giving you the option to re-install with the 'correct settings'. After that all should be well.)</li> <li>Open a shell window by running: <code>c:\mozilla-build\start-msvc8.bat</code></li> </ul> <p>Problems? See <a class="internal" href="/en/Windows_Build_Prerequisites" title="en/Windows_Build_Prerequisites">Windows build prerequisites</a>.</p> </td> </tr> </tbody>
</table>
<p> </p>
<h2>Building Firefox</h2>
<p>Building Firefox requires at least 1 GB of disk space, 500 MB of RAM, and lots of available swap space.</p>
<pre># Get the source
hg clone http://hg.mozilla.org/mozilla-central/
cd mozilla-central

# 
echo '. $topsrcdir/browser/config/mozconfig' &gt; mozconfig
echo 'mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir
echo 'mk_add_options MOZ_MAKE_FLAGS="-s -j4"' &gt;&gt; mozconfig # use -' &gt;&gt; mozconfig

# Build
make -f client.mk</pre>
<ul> <li>For a debug build, you need different configuration options in your <code>mozconfig</code> file.  This requires more disk space, about 2.5 GB.<br> <pre>. $topsrcdir/browser/config/mozconfig
mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir-ff-debug
ac_add_options --enable-debug
ac_add_options --disable-optimize
ac_add_options --enable-tests</pre> </li> <li>To build Thunderbird or SeaMonkey, you'll need <a class="internal" href="/en/Comm-central_source_code_(Mercurial)" title="En/Comm-central source code (Mercurial)">more source code</a> and some changes to your <code>mozconfig</code> file.</li> <li>On Windows, the above commands will create the <code>mozilla-central</code> directory in <code>%USERPROFILE%</code> which will likely be some subfolder of <code>c:\Documents and Settings</code>.  The space in this directory name will cause the configure script to break.  To (possibly) fix this, do "<code>cd /c:</code>" before the "<code>hg clone</code>" command above.</li> <li>The <code>firefox</code> executable can be found in <code>objdir-ff-release/dist/bin</code>/ (on Mac, <code>objdir-ff-release/dist/Minefield.app/Contents/MacOS/</code>).</li>
</ul>
<p> </p><h2>How to build again later</h2>
<p>In your <code>mozilla-central</code> directory, run these commands:</p>
<pre># Get the latest source
hg pull -r default
hg update
</pre>
<p>Then just re-run the Configure and Build commands above. <code>make</code> will only recompile files that changed, but it's still a long haul. An <a class="internal" href="/en/Incremental_Build" title="En/Incremental Build">incremental build</a> can be faster.</p>
<p>You must use the same <code>configure</code> options each time you rebuild.  To avoid this error-prone step, use a <a class="internal" href="/en/Configuring_Build_Options" title="En/Configuring Build Options"><code>mozconfig</code> file</a>.</p>
<p> </p>
Revert to this revision