Compiling PolyBrowser

As discussed in the Code Overview section of the Wiki Home Page, PolyBrowser is divided two layers. Layer 1 is a rebranded Firefox clone, and Layer 2 contains all of PolyBrowser's functionality in extensions. So to work on PolyBrowser, you generally don't need to do any code compiling because extensions don't require any compiling. However, if you wish to build the Layer 1 source code, follow these steps:

Step 1 Download Layer 1 Browser Source Code here (1.5GB) Note: The source code is for Firefox release version 36, the last known compatible version. Later versions may require code changes.

Step 2 Follow instructions provided by Mozilla for "Build Prerequisites" for setting up your environment to build Firefox (https://developer.mozilla.org/en-US/docs/Simple_Firefox_build)

• Skip the instructions for downloading the source code... You already have it.

Step 3 Modify the file in the PolyBrowser root called "mozconfig". This file provides build instructions to the compiler.

• If you're not familiar with how mozconfig works, remove all lines except for the one that says "ac_add_options --enable-official-branding" (PolyBrowser's branding is in the "Official" folder)
• To understand how mozconfig works, read this Mozilla reference (https://developer.mozilla.org/en-US/docs/Configuring_Build_Options)

4. Follow the Mozilla instructions to build

#Assembling PolyBrowser Once you've compiled the source code and build the Layer 1 browser, the following steps let you assemble the full PolyBrowser experience:

Step 1 Add a folder/subfolder within the browser directory called /distribution/bundles/ (Goes in /resources/ on OSX) In /bundles/:

• Create a folder called /{a0108b30-8567-11e1-b0c4-0800200c9a66}/ which will contain PolyBrowser's main code from this repo
• Create a folder called /superstart/ which will contains the code for PolyBrowser's New Tab page from this repo

Step 2 Download the files contained in the branch called "support-files"

• Create a folder within the /browser/ folder in the root called /defaults/ (if it doesn't already exist)
• Add the /preferences/ and /profile/ folders into /defaults/

Step 3 Within the /browser/searchplugins/ folder of the browser, add polyfetch-web-search.xml from the downloaded /Search Plugins/ folder