https://github.com/pmed/v8-nuget
NuGet package for V8 JavaScript Engine
https://github.com/pmed/v8-nuget
Last synced: 4 months ago
JSON representation
NuGet package for V8 JavaScript Engine
- Host: GitHub
- URL: https://github.com/pmed/v8-nuget
- Owner: pmed
- Created: 2016-08-29T14:00:23.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-11-09T11:21:26.000Z (over 1 year ago)
- Last Synced: 2024-05-19T14:22:10.580Z (about 1 year ago)
- Language: Python
- Size: 8.04 MB
- Stars: 88
- Watchers: 7
- Forks: 25
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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|[](https://www.nuget.org/packages/v8-v143-x64/)|
|V8 x86 for Visual Studio 2022|[](https://www.nuget.org/packages/v8-v143-x86/)|
|V8 x64 for Visual Studio 2019|[](https://www.nuget.org/packages/v8-v142-x64/)|
|V8 x86 for Visual Studio 2019|[](https://www.nuget.org/packages/v8-v142-x86/)|
|V8 x64 for Visual Studio 2017|[](https://www.nuget.org/packages/v8-v141-x64/)|
|V8 x86 for Visual Studio 2017|[](https://www.nuget.org/packages/v8-v141-x86/)|
|V8 x64 for Visual Studio 2015|[](https://www.nuget.org/packages/v8-v140-x64/)|
|V8 x86 for Visual Studio 2015|[](https://www.nuget.org/packages/v8-v140-x86/)|
|V8 x64 for Visual Studio 2013|[](https://www.nuget.org/packages/v8-v120-x64/)|
|V8 x86 for Visual Studio 2013|[](https://www.nuget.org/packages/v8-v120-x86/)|
|V8 x64 for Visual Studio 2017 XP platform toolset|[](https://www.nuget.org/packages/v8-v141_xp-x64/)|
|V8 x86 for Visual Studio 2017 XP platform toolset|[](https://www.nuget.org/packages/v8-v141_xp-x86/)|
|V8 x64 for Visual Studio 2015 XP platform toolset|[](https://www.nuget.org/packages/v8-v140_xp-x64/)|
|V8 x86 for Visual Studio 2015 XP platform toolset|[](https://www.nuget.org/packages/v8-v140_xp-x86/)|
|V8 x64 for Visual Studio 2013 XP platform toolset|[](https://www.nuget.org/packages/v8-v120_xp-x64/)|
|V8 x86 for Visual Studio 2013 XP platform toolset|[](https://www.nuget.org/packages/v8-v120_xp-x86/)|
## 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](https://en.wikipedia.org/wiki/Program_database)
After successful packages installation add `#include ` 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
```