Build and Install

  • Revision slug: Build_and_Install
  • Revision title: Build and Install
  • Revision id: 61220
  • Created:
  • Creator: Benjamin Smedberg
  • Is current revision? No
  • Comment

Revision Content

NOTE: Do not make substantive changes to this document without consulting Benjamin Smedberg <benjamin@smedbergs.us> or one of the build-config peers.

NOTE: Do not begin a build without configuring your build options first!

Building

You must use GNU make to check out and build Mozilla. No other "make" program is acceptable. On windows and mac, use "make" to run GNU make; on most unixes, use "gmake".

gmake -f client.mk build

If you wish to manually configure and build, cd to your objdir, run configure, and then run gmake. Configure will still pick up options specified in a mozconfig file.

Running Your New Build

On non-macintosh build system, the finished build can be found in objdir/dist/bin. On *nix platforms, you should run the file "mozilla" or "firefox", not the binary "mozilla-bin" or "firefox-bin".

On macintosh, the build system produces an application bundle at objdir/dist/AppName.app

Note: This build directory contains symlinks into the build tree. You must run the installation/packaging step to produce a standalone build which can be shared or moved.

Installing Your Build

On *nix platforms, you can install your build to the system by running gmake install. However, it is often better to follow the steps below to make a tarball, then unpack the tarball.

For most apps, prepare a tarball/zip of your build by making in an app-specific directory:

  • Firefox: gmake -C objdir/browser/installer
  • Thunderbird: gmake -C objdir/mail/installer
  • SeaMonkey: gmake -C objdir/xpinstall/packager

To make a windows installer, make the "installer" target in the above directory:

  • Firefox: gmake -C objdir/browser/installer installer
  • Thunderbird: gmake -C objdir/mail/installer installer
  • SeaMonkey: gmake -C objdir/xpinstall/packager installer

NOTE: To make the highly compressed installer used by Firefox and Thunderbird, you must install a few additional programs:

Both of these utilities must exist in the PATH. In addition, export MOZ_INSTALLER_USE_7ZIP.

[{{mediawiki.external('Category:Build Documentation')}}

Revision Source

<p><span class="comment">NOTE: Do not make substantive changes to this document   without consulting Benjamin Smedberg &lt;benjamin@smedbergs.us&gt;   or one of the build-config peers.</span>
</p><p>NOTE: Do not begin a build without <a href="en/Configuring_Build_Options">configuring your build options</a> first!
</p>
<h3 name="Building"> Building </h3>
<p>You must use GNU make to check out and build Mozilla. No other "make" program is acceptable. On windows and mac, use "make" to run GNU make; on most unixes, use "gmake".
</p>
<pre class="eval">gmake -f client.mk build
</pre>
<p>If you wish to manually configure and build, cd to your objdir, run configure, and then run gmake. Configure will still pick up options specified in a mozconfig file.
</p>
<h3 name="Running_Your_New_Build"> Running Your New Build </h3>
<p>On non-macintosh build system, the finished build can be found in <i>objdir</i>/dist/bin. On *nix platforms, you should run the file "mozilla" or "firefox", not the binary "mozilla-bin" or "firefox-bin".
</p><p>On macintosh, the build system produces an application bundle at <i>objdir</i>/dist/<i>AppName</i>.app
</p><p>Note: This build directory contains symlinks into the build tree. You must run the installation/packaging step to produce a standalone build which can be shared or moved.
</p>
<h3 name="Installing_Your_Build"> Installing Your Build </h3>
<p>On *nix platforms, you can install your build to the system by running <i>gmake install</i>. However, it is often better to follow the steps below to make a tarball, then unpack the tarball.
</p><p>For most apps, prepare a tarball/zip of your build by making in an app-specific directory:
</p>
<ul><li> Firefox: gmake -C objdir/browser/installer
</li><li> Thunderbird: gmake -C objdir/mail/installer
</li><li> SeaMonkey: gmake -C objdir/xpinstall/packager
</li></ul>
<p>To make a windows installer, make the "installer" target in the above directory:
</p>
<ul><li> Firefox: gmake -C objdir/browser/installer installer
</li><li> Thunderbird: gmake -C objdir/mail/installer installer
</li><li> SeaMonkey: gmake -C objdir/xpinstall/packager installer
</li></ul>
<p><i>NOTE:</i> To make the highly compressed installer used by Firefox and Thunderbird, you must install a few additional programs:
</p>
<ul><li> <a class="external" href="http://www.7-zip.org/">7-zip</a>
</li><li> <a class="external" href="http://upx.sourceforge.net/">UPX</a>
</li></ul>
<p>Both of these utilities must exist in the PATH. In addition, export MOZ_INSTALLER_USE_7ZIP.
</p><p>[{{mediawiki.external('Category:Build Documentation')}}
</p>
Revert to this revision