====== Building AllPeers ======

Ensure you have downloaded both Mozilla and AllPeers sources as described in [[src:getting|Getting the Source]].

===== Set up .mozconfig files =====

  * Copy '.mozconfig-debug' or '.mozconfig-release' from extensions/allpeers to the Mozilla source directory root with name .mozconfig. Alternatively it may be put to your home directory (on Windows use c:\cygwin\home\%USERNAME%).
  * If you want support for importing contacts from Microsoft Outlook to be compiled (and you have Outlook installed), add the following line to 'myconfig.mk' (placed in the root of allpeers tree, create the file, if it doesn't exist):
<code>
export AP_WITH_OUTLOOK=1
</code>

==== Conditional Compilation ====

AllPeers uses conditional compilation to build different XPIs for different deployment (testing version, rc version). The building is straightforward, take proper **.mozconfig-*** from superman module and copy it to your home or mozilla directory with name **.mozconfig** .

==== HEAD and RC branch in parallel ====

In order to reduce risk of using wrong configurations when working on both HEAD and Release Candidate branch, it is recommended to checkout HEAD branch of superman into **mozilla/extensions/allpeers** and the RC branch to **mozilla/extensions/allpeers-rc**. Use **.mozconfig-*-rc** to build the Firefox which will use the **allpeers-rc** directory instead of **allpeers**.

===== GPL Libraries =====

If you want to have GPL libraries enabled in your build (currently MFP), you can set AP_WITH_GPL_LIBRARIES to 1 in ''license.mk'' file in the root of AllPeers source directory. Notice, that product built in this way must be distributed under GPL license, because it contains GPL libraries (MPL and LGPL cannot be used).



===== Build Mozilla and AllPeers =====

After all previous steps are done, run:

<code>make -f client.mk build
#Your Mozilla is here /mozilla\_obj-browser-release/dist/bin/firefox.exe
</code>

Please refer to [[http://developer.mozilla.org/en/docs/Build_Documentation|Mozilla's building documentation]] to get help in building mozilla.