This is the source code for the Flashpoint Web Browser, a web browser based up on Basilisk which is then derrived from Firefox / Mozilla community code.
The browser uses Unified XUL Platform source as the browsers code and is referenced as a git submodule contained in the platform/
directory and is required to build the application.
Start with getting the platform sub-module by running the command:
git submodule init && git submodule update
Short-guide for building on Windows.
Make sure you have plenty of disk space and at least 8GB of ram with 2 or more cores, the more the better. Running Windows 7 or newer with 64-bit.
Make sure to clone the repository to a path without spaces, i.e.: C:\fpbrowser
The following build tools is necessary:
-
Microsoft Visual Studio 2015 (Community Edition (free) or Pro/Paid version -- Express will not work) with updates.
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.
-
Exactly Windows 10 SDK version 10.0.19041.0 (with servicing update .685)
You need to launch the proper build tools ennvironment for target architecture
- x86:
C:\mozilla-build\start-shell-msvc2015.bat
- or x64:
C:\mozilla-build\start-shell-msvc2015-x64.bat.bat
to enter a Linux-like environment (MSYS).
Navigate to the directory of the source code:
cd /c/fpbrowser
execute the pre-defined build script which will build and package it for you depending on what you want to build.
./scripts/build_windows_x86.sh
or
./scripts/build_windows_x64.sh
When finished you will get a new folder named obj*
that contains the finished build inside dist
folder
To build for Mac you need to setup a proper build environment. You need will the following toolset listed below which are going to be installed following this short guide.
- OS X 10.13 (HighSierra)
- Xcode 8 (Or higher) + Command-line tools for Xcode
- Apple 10.13 SDK
- Autoconf-2.13
- ccache
- Python 2.7
- libidl
- yasm 1.2 or higher
At least 8GB of ram required along with plenty of disk space!
You need to install Homebrew so that necessary third-party tools can be installed.
Install Xcode 8 (or higher) + Command line tools for Xcode
Open a new terminal and run the following command to install necessary tools using Brew: This will also install necessary Python 2.7 developing headers
brew tap matt-chapman/python2
brew update
brew install automake ccache libidl libtool python@2
Now bootstrap the environment by running the following command in the cloned directory where FPBrowser lives. This will fetch the necessary build tools required. (Note that this will take a long time as pre-built packages may not be available and all the tools need to be compiled from source)
You will have to apply a patch first to fix boostraping on Mac.
patch < patches/001-fix-mach-bootstrap-on-osx.patch
./mach bootstrap
To build on mac, simple export the MOZCONFIG variable to predefined mozconfig
export MOZCONFIG=configs/mozconfig-mac_x64
Build the project as usual:
./mach build
When finished you will get a new folder named obj*
that contains the finished build inside dist
folder.
If you want to package for release run the command: ./mach package
License is MPL 2.0