Prerequisites
- Microsoft Visual Studio 2015 (Community Edition (free) or Pro/Paid version -- Express won't work)
We will assume here you are using the Community Edition. - MozillaBuild 2.x, e.g. 2.2
- At least 4 GB Ram (8 GB or more recommended)
- Plenty of free disk space
- At least Windows 7 64-bit
- To get Visual Studio 2015 CE you need a Developer Account (simply a Microsoft account). Microsoft will try to push VS 2017 on you but that will not work. You must get 2015 from the "previous versions" part of the site.
- Launch VS2015 after installation to initialize the environment, start the IDE and get the latest updates. Launch after updating to finish up the update, after which you can close the IDE. For x64 builds, make sure you install the x64 build tools
(Note: You will be asked to register with Microsoft when launching it the first time; simply log in with your developer account in the IDE and you're set.) - Make sure you install the correct components for "C++ development"; other languages are not necessary and not installing them will save you (heaps of) disk space.
Download the source from http://www.palemoon.org/sourcecode.shtml or clone the UXP repo with git.
Make sure you unpack/clone to a path that does not contain spaces, e.g. c:\palemoon-source to prevent build system issues.
If you cloned the git repo be sure to switch to the desired release branch. Since the UXP platform repo contains multiple applications and trunk may be unstable, this is important.
This source tree will contain everything needed for both x86 and x64 builds of Pale Moon (they share the same release source code).
Build Instructions
Configure
Create a file called .mozconfig in the source folder you unpacked the source in.
(Yes, that is {dot}mozconfig -- don't omit the . at the start. Also make sure it's not .mozconfig.txt or something crooked like that. If you are hiding extensions of known file types, fix that first in folder options because it's a PITA when trying to do this kind of thing)
Alternatively, create a text file of any name in your home folder or a folder of your choice, and use
Code: Select all
export MOZCONFIG=path/to/your/mozconfig.txt
Note: the command prompt when building is a unix-like environment which uses forward slashes for paths.
Make sure it contains at least the following for a close-to-official build:
For x86 (32-bit):
Code: Select all
ac_add_options --enable-application=palemoon
ac_add_options --enable-optimize="-O2"
ac_add_options --enable-jemalloc
ac_add_options --disable-eme
ac_add_options --disable-webrtc
ac_add_options --enable-devtools
ac_add_options --disable-gamepad
ac_add_options --disable-parental-controls
WIN32_REDIST_DIR=$VCINSTALLDIR/redist/x86/Microsoft.VC140.CRT
WIN_UCRT_REDIST_DIR="C:/Program Files (x86)/Windows Kits/10/Redist/ucrt/DLLs/x86"
Code: Select all
ac_add_options --enable-application=palemoon
ac_add_options --enable-optimize="-O2"
ac_add_options --enable-jemalloc
ac_add_options --disable-eme
ac_add_options --disable-webrtc
ac_add_options --enable-devtools
ac_add_options --disable-gamepad
ac_add_options --disable-parental-controls
WIN32_REDIST_DIR=$VCINSTALLDIR/redist/x64/Microsoft.VC140.CRT
WIN_UCRT_REDIST_DIR="C:/Program Files (x86)/Windows Kits/10/Redist/ucrt/DLLs/x64"
Code: Select all
ac_add_options --disable-tests
Build
- Go to C:\mozilla-build (or wherever you extracted to mozilla build tools) and run start-shell-msvc2015.bat
This will open a UNIX-like shell with the compile environment set up for Visual Studio 2015 with a 32-bit target. Please do not use the -x64 batch file just because you are on a 64-bit O.S. when building x86.
The -x64 batch file is for launching a 64-bit build environment and building a 64-bit browser. So for creating an x64 build of Pale Moon, run start-shell-msvc2015-x64.bat - In the shell, cd to your pale moon source directory, e.g.
if you installed the source in C:\palemoon-source
Code: Select all
cd /c/palemoon-source
- Start the build:
Code: Select all
./mach build
- Be patient. Building will take a while. Your PC will be fully occupied compiling and linking the browser (you can expect 100% CPU usage throughout and lots of memory use - provide ample cooling) and you should not be using it for anything else that is intensive at this time. Especially memory-intensive applications should be avoided because it can cause issues with the linker (memory fragmentation) resulting in a very unstable browser.
Strip/Package
After building is completed, you can take the resulting binaries for a test run in the object directory directly (see the on-screen instructions at the end of the build process) but it will not be complete yet. You need to strip and package the browser binaries to integrate additional code, pack up the omnijar files, and have a ready-to-use browser. You do this by running
Code: Select all
./mach package
C:\palemoon-source\obj-i686-pc-mingw32\dist\palemoon-{version}.en-US.win32.zip (for x86)
Generating the installer
If you want to build a self-extracting installer, similar to the off-line installers offered in official builds, you will have to do give the following command:
Code: Select all
./mach installer
C:\palemoon-source\obj-i686-pc-mingw32\dist\install\sea\palemoon-{version}.en-US.win32.installer.exe (for x86)