chromium-prebuilds

Build definitions for making prebuilds of Chromium modules.

Setup

Like Chromium itself, this repository is not intended for checkout using git clone. Instead, start by installing depot_tools which is a toolset used for fetching and managing the Chromium source repositories. Next, create a new directory that will contain the Chromium sources and change into it:

mkdir chromium && cd chromium

Then, create a .gclient configuration file that will fetch this repository and its dependencies:

gclient config --name src/prebuilds [--cache-dir <path>] --unmanaged git@github.com:holepunchto/chromium-prebuilds.git

The --cache-dir argument, if provided, should point to a path, such as ~/.git_cache/, that will be used for caching all cloned git repositories. When finished, fetch the repository and its dependencies:

gclient sync

This will take a while depending on the speed of your connection. When completed, create a link to the fetched build tools to mark the root of the build tree:

# POSIX
ln -s src/buildtools buildtools

# Windows
mklink /j buildtools src\buildtools

Patching

The build definitions rely on a few patches that must be manually applied after each gclient sync. The patches are separated by submodule and can be applied using git:

git apply --directory src[/<submodule>] src/prebuilds/patches[/<submodule>]/*.patch

Make sure to revert the patches before doing another gclient sync as it requires a clean working tree:

git apply --reverse --directory src[/<submodule>] src/prebuilds/patches[/<submodule>]/*.patch

Building

To build the various Chromium modules, start by changing into the src/ directory:

cd src

Next, generate a build system using gn for your desired target and module, replacing <target> with one of the supported targets as defined by target/ and <module> with one of v8, content, or webrtc:

# POSIX
gn gen out/<target>/<module> --args="import(\"//prebuilds/<module>.gni\") import(\"//prebuilds/mode/<release|debug>.gni\") import(\"//prebuilds/target/<target>.gni\")"

# Windows
gn gen out/<target>/<module> --args="import(\`"//prebuilds/<module>.gni\`") import(\`"//prebuilds/mode/<release|debug>.gni\`") import(\`"//prebuilds/target/<target>.gni\`")"

gn gen out/linux-arm64/v8 --args="import(\"//prebuilds/v8.gni\") import(\"//prebuilds/mode/release.gni\") import(\"//prebuilds/target/linux-arm64.gni\")"

gn gen out/win32-x64/v8 --args="import(\`"//prebuilds/v8.gni\`") import(\`"//prebuilds/mode/release.gni\`") import(\`"//prebuilds/target/win32-x64.gni\`")"

Finally, run the build system for the prebuilds target:

ninja -C out/<target>/<module> prebuilds

License

Apache-2.0