NuGet package for V8 JavaScript Engine

This packages contain prebuilt V8 binaries, debug symbols, headers and libraries required to embed the V8 JavaScript engine into a C++ project.

Package	Version
V8 x64 for Visual Studio 2022
V8 x86 for Visual Studio 2022
V8 x64 for Visual Studio 2019
V8 x86 for Visual Studio 2019
V8 x64 for Visual Studio 2017
V8 x86 for Visual Studio 2017
V8 x64 for Visual Studio 2015
V8 x86 for Visual Studio 2015
V8 x64 for Visual Studio 2013
V8 x86 for Visual Studio 2013
V8 x64 for Visual Studio 2017 XP platform toolset
V8 x86 for Visual Studio 2017 XP platform toolset
V8 x64 for Visual Studio 2015 XP platform toolset
V8 x86 for Visual Studio 2015 XP platform toolset
V8 x64 for Visual Studio 2013 XP platform toolset
V8 x86 for Visual Studio 2013 XP platform toolset

Usage

To use V8 in a project install the package v8-$PlatformToolset-$Platform.$Version from a console with nuget install command or from inside of Visual Studio (see menu option Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution...) where

• $PlatformToolset is the C++ toolset version used in Visual Studio:

  • v120 - for Visual Studio 2013
  • v140 - for Visual Studio 2015
  • v141 - for Visual Studio 2017
  • v142 - for Visual Studio 2019
  • v143 - for Visual Studio 2022
  • v120_xp - for Visual Studio 2013 XP platform toolset
  • v140_xp - for Visual Studio 2015 XP platform toolset
  • v141_xp - for Visual Studio 2017 XP platform toolset

• $Platform is a target platform type, currently x86 or x64.

• $Version is the actual V8 version, one of https://chromium.googlesource.com/v8/v8.git/+refs

There are 3 package kinds:

• v8-$PlatformToolset-$Platform.$Version - contains developer header and library files; depends on v8.redist package

• v8.redist-$PlatformToolset-$Platform.$Version - prebuilt V8 binaries: dlls, blobs, etc.

• v8.symbols-$PlatformToolset-$Platform.$Version - debug symbols for V8: pdb files

After successful packages installation add #include <v8.h> in a C++ project and build it. All necessary files (*.lib, *.dll, *.pdb) would be referenced in the project automatically with MsBuild property sheets.

How to build

This section is mostly for the package maintainers who wants to update V8.

Tools required to build V8 NuGet package on Windows:

• Visual C++ toolset (version >=2022)
• Python 3.x
• Git >= 1.9
• NuGet (https://dist.nuget.org/index.html)

To build V8 and make NuGet packages:

1. Run build.py with optional command-line arguments.
2. Publish nuget/*.nupkg files after successful build.

Build script build.py supports command-line arguments to specify package build options:

1. V8 version branch/tag name --version, default is lkgr branch (last known good revision)
2. Platform --platform, default are both [x86, x64]
3. Configuration --config, default are both [Debug, Release]
4. Libraries kind --libs, default are both [shared, monolith] (i.e. dll and static libs)
5. Additional V8 gn options --gn-option in key=value format
6. Print all available options with --help switch

For example, to build V8 version 12.8 for x64 dlls, both debug and release run it as:

python3 build.py --version=12.8 --platform=x64 --libs=shared