This repository contains automated builds of Google V8 static libraries for multiple platforms using GitHub Actions.

English | 简体中文

14.3.92

• Android (arm64, arm, x64)
• iOS (XCFramework: arm64 device, arm64 simulator)
• macOS (XCFramework: arm64 Apple Silicon)
• Windows (x64)

Check the Releases page for the latest precompiled binaries.

Each release includes zip packages with:

• Static library file (libv8_monolith.a / v8_monolith.lib)
• args.gn - Build configuration used for compilation
• args.full.txt - Complete GN arguments list with all default values and descriptions

The repository contains GN build configuration files for each platform:

• args.android.arm64.gn
• args.android.arm.gn
• args.android.x64.gn

• args.ios.arm64.gn - Device configuration
• args.ios.arm64.simulator.gn - Simulator configuration

Note: The iOS build produces an XCFramework that supports both arm64 device and arm64 simulator platforms.

iOS XCFramework Structure:

libv8_monolith.xcframework/
├── ios-arm64/                          # Device
│   └── libv8_monolith.framework/
│       ├── Headers/                    # V8 header files
│       ├── libv8_monolith              # Static library
│       └── Info.plist
└── ios-arm64-simulator/                # Simulator
    └── libv8_monolith.framework/
        ├── Headers/                    # V8 header files
        ├── libv8_monolith              # Static library
        └── Info.plist

Usage in Xcode:

1. Drag libv8_monolith.xcframework into your Xcode project
2. Add to "Frameworks, Libraries, and Embedded Content"
3. Import headers: #include <libv8_monolith/v8.h>
4. Xcode automatically selects the correct variant (device/simulator)

• args.mac.arm64.gn

Note: The macOS build produces an XCFramework for arm64 (Apple Silicon).

macOS XCFramework Structure:

libv8_monolith.xcframework/
└── macos-arm64/                        # Apple Silicon
    └── libv8_monolith.framework/
        ├── Headers/                    # V8 header files
        ├── libv8_monolith              # Static library
        └── Info.plist

Usage in Xcode: Same as iOS, drag and drop into your project

• args.win.x64.gn

• Info.plist.template - Template for XCFramework Info.plist (version is replaced during build)

• ✅ Automated builds via GitHub Actions
• ✅ Consistent configuration across platforms
• ✅ Pre-build scripts for platform-specific optimizations (builder.js)
• ✅ Full build argument traceability
• ✅ iOS WebAssembly support enabled

1. Download the appropriate zip file for your platform from the Releases page
2. Extract the static library file
3. Link against the library in your project
4. Include the V8 headers (included in the release)
5. Refer to args.gn and args.full.txt to understand the build configuration

All builds are automated using GitHub Actions:

• Clean build environment for each platform
• Consistent depot_tools version
• Reproducible builds
• Automated release creation

• V8 Build Instructions
• V8 Build with GN
• V8 ARM64 Build

• Windows Build Instructions
• Android Build Instructions
• iOS Build Instructions
• macOS Build Instructions
• macOS ARM64 Build

• V8 Release Schedule
• GitHub Actions Runner Images

To update the V8 version or modify build configurations:

1. Update V8_VERSION in .github/workflows/main.yml
2. Modify platform-specific args.*.gn files as needed
3. Update builder.js for platform-specific build logic
4. Create a new git tag to trigger the build workflow

This project is inspired by and references the work from just-js/v8.

This repository contains build configurations and automation scripts. V8 itself is licensed under the BSD license. See the V8 repository for details.