NOTICE (2019-03-22): Not all platforms are updated yet. If your platform is not updated yet, please use the instructions and code in tag 72.0.3626.122-2
The recommended way to build ungoogled-chromium is by consulting the repository for your supported platform (links here).
- Linux users: If your distribution is not listed, you will need to use Portable Linux.
If you want to know how to use ungoogled-chromium's build process in your own Chromium builds, you may have a look at the rough example below. Additionally, you may reference the repositories for supported platforms for inspiration.
NOTE: This example is intended only for users who want to learn how ungoogled-chromium's build process works. If you are simply trying to build and run ungoogled-chromium, please consult the repository for your supported platform.
In order to get a working build from this example, you will need to develop your own build process. This may be a time-consuming process. Before continuing, you should be familiar with the standard Chromium build process, and ungoogled-chromium's design documentation.
The following example demonstrates a typical build process. Please note that these steps alone will probably not be sufficient to get a working build.
- Download and unpack the source code:
mkdir -p build/download_cache
./utils/downloads.py retrieve -c build/download_cache -i downloads.ini
./utils/downloads.py unpack -c build/download_cache -i downloads.ini -- build/src- Prune binaries:
./utils/prune_binaries.py build/src pruning.list- Apply patches:
./utils/patches.py apply build/src patches- Substitute domains:
./utils/domain_substitution.py apply -r domain_regex.list -f domain_substitution.list -c build/domsubcache.tar.gz build/src- Build GN:
mkdir -p build/src/out/Default
cp flags.gn build/src/out/Default/args.gn
cd build/src
./tools/gn/bootstrap/bootstrap.py --skip-generate-buildfiles -j4 -o out/Default/gn- Build Chromium:
./out/Default/gn gen out/Default --fail-on-unused-args
ninja -C out/Default chrome chromedriver chrome_sandbox