v8 monolithic library builds

this repo containes up-to-date builds of the google v8 monolithic libraries for the following platforms

current release

• tag
• v8 headers
• v8 source

linux x64 ✅

• static libraries
• build args
• generated source code

linux arm64 ✅

• static libraries
• build args
• generated source code

macos x64 ✅

• static libraries
• build args
• generated source code

macos arm64 ✅

• static libraries
• build args
• generated source code

windows x64 ✅

• static library
• build args
• generated source code
• libc++ headers

planned

• riscv64
• android64
• iOS

local dev tools

See tools/README.md.

args

See doc/ARGS.md for a full matrix of the GN args set across all 6 args.*.gn files, what each does, and alternatives, and doc/V8-BUILD-OPTS.md for the deeper performance/startup-memory tradeoffs behind a subset of them.

release schedule

• https://chromiumdash.appspot.com/schedule

github actions runner images

• linux (x64) → ubuntu-22.04 → https://github.com/actions/runner-images/blob/main/images/ubuntu/Ubuntu2204-Readme.md
• linux (arm64) → ubuntu-22.04-arm → https://github.com/actions/partner-runner-images/blob/main/images/arm-ubuntu-22-image.md (a different repo than the x64 image above - GitHub's Arm-partner images aren't documented in actions/runner-images)
• mac (x64 + arm64) → macos-15 → https://github.com/actions/runner-images/blob/main/images/macos/macos-15-Readme.md
• windows (x64) → windows-2022 → https://github.com/actions/runner-images/blob/main/images/windows/Windows2022-Readme.md

patches

Some V8 branch-heads ship with real, confirmed source bugs (missing #includes, a std::optional::value_or({}) template-deduction failure, etc.) that don't reproduce in Google's own CI - most likely because this build intentionally sets use_custom_libcxx=false/use_sysroot=false (see each platform's args.*.gn above), compiling against each runner's own system C++ standard library instead of Chromium's pinned/vendored one. Small unified-diff patches for known-bad branch-heads live in patches/ and get applied automatically to every platform job right before compiling - see patches/README.md for the mechanism and the current list of what's patched and why.

external references

• https://v8.dev/docs/compile-arm64
• https://v8.dev/docs/build
• https://v8.dev/docs/build-gn
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/windows_build_instructions.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/android_build_instructions.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/ios/build_instructions.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/linux/build_instructions.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/linux/chromium_arm.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/linux/sysroot.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/mac_build_instructions.md
• https://chromium.googlesource.com/chromium/src/+/HEAD/docs/mac_arm64.md