如何在 Windows 上嵌入 v8？
How do I embed v8 on Windows?
如何使用 Visual Studio 在 Windows 上编译和嵌入 v8？ The official guide 在 Linux 上工作，但在 Windows 和 Visual Studio 上没有工作，因为我在尝试构建 v8 和示例项目时不断遇到编译错误。
v8 的构建过程似乎经常更改。那里有一些教程，但它们似乎都已过时。因此，在 Chromium 团队决定再次更改之前，这些步骤暂时应该有效。
获取 depot 工具和 v8 源代码
这些步骤复制自 here。
- 卸载Python。我遇到了问题，v8 编译器脚本发现了错误的 Python 可执行文件，而不是 depot 工具中提供的可执行文件。暂时卸载 Python.
让您的生活更轻松
- 配置Visual Studio和您的开发环境。您需要带有组件“使用 C++ 进行桌面开发”和“MFC/ATL 支持”的 VS2019。您将需要 Windows 10 SDK 和“Windows 的调试工具”功能。
- 下载 depot_tools bundle 并将其解压到某处。
警告：请勿使用从资源管理器中拖放或复制粘贴提取，这不会提取 depot_tools 所需的隐藏“.git”文件夹自动更新本身。不过，您可以从上下文菜单中使用“全部提取...”。
- 将 depot_tools 添加到 PATH 的开头（必须在 Python 的任何安装之前）。假设您将包解压缩到
C:\src\depot_tools，打开：
控制面板→系统和安全→系统→高级系统设置
如果您有管理员访问权限，修改 PATH 系统变量并将 C:\src\depot_tools 放在前面（或至少在任何可能已经有 Python 或 Git).
如果你没有Administrator权限，你可以添加一个用户级的PATH环境变量，把C:\src\depot_tools放在最前面，但是如果你的系统PATH里面有一个Python，你会倒霉的。
- 同样的方法添加一个
DEPOT_TOOLS_WIN_TOOLCHAIN系统变量，设置为0。这告诉 depot_tools 使用本地安装的 Visual Studio 版本（默认情况下，depot_tools 将尝试使用 google-内部版本）。
您可能还需要将变量 vs2017_install 或 vs2019_install 设置为 Visual Studio 2017 或 19 的安装路径，例如 set vs2019_install=C:\Program Files (x86)\Microsoft Visual Studio19\Professional 用于 Visual Studio 2019 .
- 来自cmd.exeshell、运行命令
gclient。首先 运行，gclient 将安装使用代码所需的所有 Windows 特定位，包括 msysgit 和 python.
- 如果您 运行 来自非 cmd shell 的 gclient（例如，cygwin、PowerShell），它可能看起来 运行 正确，但是 msysgit， python，其他工具可能无法正确安装。
- 如果您在 gclient 的第一个 运行 上看到文件系统出现奇怪的错误，您可能需要禁用 Windows 索引。
打开命令提示符并键入 where python 并确认 depot_tools python.bat 位于 python.exe 的任何副本之前。未能确保这一点会导致在使用 gn 时过度构建。
App Execution Aliases 可能与系统上 python 的其他安装冲突，因此通过打开 Control 的 App execution aliases 部分为 python.exe 和 python3.exe 禁用这些面板并取消选中这两个指向应用程序安装程序旁边的框。
cd到你要存放v8的目录下 运行 mkdir v8 && cd v8 && fetch v8.
cd v8 和 git checkout 9.0.257.19，这是撰写本文时最新的稳定版本。
应用此补丁：
diff --git a/BUILD.gn b/BUILD.gn
index a9ab6783fa..ede2774d18 100644
--- a/BUILD.gn
+++ b/BUILD.gn
@@ -1051,6 +1051,7 @@ config("toolchain") {
"/wd4723", # https://crbug.com/v8/7771
"/wd4724", # https://crbug.com/v8/7771
"/wd4800", # Forcing value to bool.
+ "/wd4805",
]
}
这是为了消除有关将布尔值与整数进行比较的警告。希望他们知道自己在做什么。
- 运行
gclient sync 获取所有依赖项。
编译 v8
运行 python tools/dev/v8gen.py x64.debug.
将v8\out.gn\x64.debug\args.gn的内容替换为：
is_debug = true
target_cpu = "x64"
v8_enable_backtrace = true
v8_enable_slow_dchecks = true
v8_optimized_debug = false
v8_monolithic = true
v8_use_external_startup_data = false
is_component_build = false
is_clang = false
运行 ninja -C out.gn/x64.debug v8_monolith.
运行 python tools/dev/v8gen.py x64.release.
将v8\out.gn\x64.release\args.gn的内容替换为：
is_debug = false
target_cpu = "x64"
is_component_build = false
v8_monolithic = true
v8_use_external_startup_data = false
is_component_build = false
is_clang = false
- 运行
ninja -C out.gn/x64.release v8_monolith.
你好世界
在 Visual Studio 中创建一个新的空 C++ 项目。
将库目录添加到项目中。
- 转到您的项目属性并将配置更改为所有配置和平台为 x64。
- 在 VC++ Directories 下，将
v8\include 的绝对路径添加到 Include Directories。在此步骤之后以及以下每个步骤之后单击“应用”。
- 将配置更改为调试并将
v8\out.gn\x64.debug\obj 的绝对路径添加到库目录。
- 对发布配置重复步骤 3，路径为
v8\out.gn\x64.release\obj。
- 更改为所有配置，转到链接器 |在Additional Dependencies中输入并添加如下文件：
v8_monolith.lib;dbghelp.lib;Winmm.lib;.
- 转到C/C++ |预处理器并将
V8_COMPRESS_POINTERS;_ITERATOR_DEBUG_LEVEL=0; 添加到预处理器定义中。
- 更改为调试配置。转到 C/C++ |代码生成并将 运行time 库更改为多线程调试 (/MTd)。
- 更改为发布配置。将 运行time 库更改为多线程 (/MT)。
添加一个新的 main.cpp 文件并添加以下代码，该代码是对 v8\samples\hello-world.cc.
稍作修改的版本
// Copyright 2015 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "libplatform/libplatform.h"
#include "v8.h"
int main(int argc, char* argv[]) {
// Initialize V8.
v8::V8::InitializeICUDefaultLocation(argv[0]);
v8::V8::InitializeExternalStartupData(argv[0]);
std::unique_ptr<v8::Platform> platform = v8::platform::NewDefaultPlatform();
v8::V8::InitializePlatform(platform.get());
v8::V8::Initialize();
// Create a new Isolate and make it the current one.
v8::Isolate::CreateParams create_params;
create_params.array_buffer_allocator =
v8::ArrayBuffer::Allocator::NewDefaultAllocator();
v8::Isolate* isolate = v8::Isolate::New(create_params);
{
v8::Isolate::Scope isolate_scope(isolate);
// Create a stack-allocated handle scope.
v8::HandleScope handle_scope(isolate);
// Create a new context.
v8::Local<v8::Context> context = v8::Context::New(isolate);
// Enter the context for compiling and running the hello world script.
v8::Context::Scope context_scope(context);
{
// Create a string containing the JavaScript source code.
v8::Local<v8::String> source =
v8::String::NewFromUtf8Literal(isolate, "'Hello' + ', World!'");
// Compile the source code.
v8::Local<v8::Script> script =
v8::Script::Compile(context, source).ToLocalChecked();
// Run the script to get the result.
v8::Local<v8::Value> result = script->Run(context).ToLocalChecked();
// Convert the result to an UTF8 string and print it.
v8::String::Utf8Value utf8(isolate, result);
printf("%s\n", *utf8);
}
{
// Use the JavaScript API to generate a WebAssembly module.
//
// |bytes| contains the binary format for the following module:
//
// (func (export "add") (param i32 i32) (result i32)
// get_local 0
// get_local 1
// i32.add)
//
const char csource[] = R"(
let bytes = new Uint8Array([
0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00, 0x01, 0x07, 0x01,
0x60, 0x02, 0x7f, 0x7f, 0x01, 0x7f, 0x03, 0x02, 0x01, 0x00, 0x07,
0x07, 0x01, 0x03, 0x61, 0x64, 0x64, 0x00, 0x00, 0x0a, 0x09, 0x01,
0x07, 0x00, 0x20, 0x00, 0x20, 0x01, 0x6a, 0x0b
]);
let module = new WebAssembly.Module(bytes);
let instance = new WebAssembly.Instance(module);
instance.exports.add(3, 4);
)";
// Create a string containing the JavaScript source code.
v8::Local<v8::String> source =
v8::String::NewFromUtf8Literal(isolate, csource);
// Compile the source code.
v8::Local<v8::Script> script =
v8::Script::Compile(context, source).ToLocalChecked();
// Run the script to get the result.
v8::Local<v8::Value> result = script->Run(context).ToLocalChecked();
// Convert the result to a uint32 and print it.
uint32_t number = result->Uint32Value(context).ToChecked();
printf("3 + 4 = %u\n", number);
}
}
// Dispose the isolate and tear down V8.
isolate->Dispose();
v8::V8::Dispose();
v8::V8::ShutdownPlatform();
delete create_params.array_buffer_allocator;
return 0;
}
- 编译和运行 调试和发布配置。他们应该输出：
Hello, World!
3 + 4 = 7
如何使用 Visual Studio 在 Windows 上编译和嵌入 v8？ The official guide 在 Linux 上工作，但在 Windows 和 Visual Studio 上没有工作，因为我在尝试构建 v8 和示例项目时不断遇到编译错误。
v8 的构建过程似乎经常更改。那里有一些教程，但它们似乎都已过时。因此，在 Chromium 团队决定再次更改之前，这些步骤暂时应该有效。
获取 depot 工具和 v8 源代码
这些步骤复制自 here。
- 卸载Python。我遇到了问题，v8 编译器脚本发现了错误的 Python 可执行文件，而不是 depot 工具中提供的可执行文件。暂时卸载 Python. 让您的生活更轻松
- 配置Visual Studio和您的开发环境。您需要带有组件“使用 C++ 进行桌面开发”和“MFC/ATL 支持”的 VS2019。您将需要 Windows 10 SDK 和“Windows 的调试工具”功能。
- 下载 depot_tools bundle 并将其解压到某处。
警告：请勿使用从资源管理器中拖放或复制粘贴提取，这不会提取 depot_tools 所需的隐藏“.git”文件夹自动更新本身。不过，您可以从上下文菜单中使用“全部提取...”。
- 将 depot_tools 添加到 PATH 的开头（必须在 Python 的任何安装之前）。假设您将包解压缩到
C:\src\depot_tools，打开：
控制面板→系统和安全→系统→高级系统设置
如果您有管理员访问权限，修改 PATH 系统变量并将 C:\src\depot_tools 放在前面（或至少在任何可能已经有 Python 或 Git).
如果你没有Administrator权限，你可以添加一个用户级的PATH环境变量，把C:\src\depot_tools放在最前面，但是如果你的系统PATH里面有一个Python，你会倒霉的。
- 同样的方法添加一个
DEPOT_TOOLS_WIN_TOOLCHAIN系统变量，设置为0。这告诉 depot_tools 使用本地安装的 Visual Studio 版本（默认情况下，depot_tools 将尝试使用 google-内部版本）。
您可能还需要将变量 vs2017_install 或 vs2019_install 设置为 Visual Studio 2017 或 19 的安装路径，例如 set vs2019_install=C:\Program Files (x86)\Microsoft Visual Studio19\Professional 用于 Visual Studio 2019 .
- 来自cmd.exeshell、运行命令
gclient。首先 运行，gclient 将安装使用代码所需的所有 Windows 特定位，包括 msysgit 和 python.
- 如果您 运行 来自非 cmd shell 的 gclient（例如，cygwin、PowerShell），它可能看起来 运行 正确，但是 msysgit， python，其他工具可能无法正确安装。
- 如果您在 gclient 的第一个 运行 上看到文件系统出现奇怪的错误，您可能需要禁用 Windows 索引。
打开命令提示符并键入
where python并确认 depot_toolspython.bat位于python.exe的任何副本之前。未能确保这一点会导致在使用 gn 时过度构建。App Execution Aliases 可能与系统上 python 的其他安装冲突，因此通过打开 Control 的 App execution aliases 部分为
python.exe和python3.exe禁用这些面板并取消选中这两个指向应用程序安装程序旁边的框。cd到你要存放v8的目录下 运行mkdir v8 && cd v8 && fetch v8.cd v8和git checkout 9.0.257.19，这是撰写本文时最新的稳定版本。应用此补丁：
diff --git a/BUILD.gn b/BUILD.gn
index a9ab6783fa..ede2774d18 100644
--- a/BUILD.gn
+++ b/BUILD.gn
@@ -1051,6 +1051,7 @@ config("toolchain") {
"/wd4723", # https://crbug.com/v8/7771
"/wd4724", # https://crbug.com/v8/7771
"/wd4800", # Forcing value to bool.
+ "/wd4805",
]
}
这是为了消除有关将布尔值与整数进行比较的警告。希望他们知道自己在做什么。
- 运行
gclient sync获取所有依赖项。
编译 v8
运行
python tools/dev/v8gen.py x64.debug.将
v8\out.gn\x64.debug\args.gn的内容替换为：
is_debug = true
target_cpu = "x64"
v8_enable_backtrace = true
v8_enable_slow_dchecks = true
v8_optimized_debug = false
v8_monolithic = true
v8_use_external_startup_data = false
is_component_build = false
is_clang = false
运行
ninja -C out.gn/x64.debug v8_monolith.运行
python tools/dev/v8gen.py x64.release.将
v8\out.gn\x64.release\args.gn的内容替换为：
is_debug = false
target_cpu = "x64"
is_component_build = false
v8_monolithic = true
v8_use_external_startup_data = false
is_component_build = false
is_clang = false
- 运行
ninja -C out.gn/x64.release v8_monolith.
你好世界
在 Visual Studio 中创建一个新的空 C++ 项目。
将库目录添加到项目中。
- 转到您的项目属性并将配置更改为所有配置和平台为 x64。
- 在 VC++ Directories 下，将
v8\include的绝对路径添加到 Include Directories。在此步骤之后以及以下每个步骤之后单击“应用”。 - 将配置更改为调试并将
v8\out.gn\x64.debug\obj的绝对路径添加到库目录。 - 对发布配置重复步骤 3，路径为
v8\out.gn\x64.release\obj。 - 更改为所有配置，转到链接器 |在Additional Dependencies中输入并添加如下文件：
v8_monolith.lib;dbghelp.lib;Winmm.lib;. - 转到C/C++ |预处理器并将
V8_COMPRESS_POINTERS;_ITERATOR_DEBUG_LEVEL=0;添加到预处理器定义中。 - 更改为调试配置。转到 C/C++ |代码生成并将 运行time 库更改为多线程调试 (/MTd)。
- 更改为发布配置。将 运行time 库更改为多线程 (/MT)。
添加一个新的
稍作修改的版本main.cpp文件并添加以下代码，该代码是对v8\samples\hello-world.cc.
// Copyright 2015 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "libplatform/libplatform.h"
#include "v8.h"
int main(int argc, char* argv[]) {
// Initialize V8.
v8::V8::InitializeICUDefaultLocation(argv[0]);
v8::V8::InitializeExternalStartupData(argv[0]);
std::unique_ptr<v8::Platform> platform = v8::platform::NewDefaultPlatform();
v8::V8::InitializePlatform(platform.get());
v8::V8::Initialize();
// Create a new Isolate and make it the current one.
v8::Isolate::CreateParams create_params;
create_params.array_buffer_allocator =
v8::ArrayBuffer::Allocator::NewDefaultAllocator();
v8::Isolate* isolate = v8::Isolate::New(create_params);
{
v8::Isolate::Scope isolate_scope(isolate);
// Create a stack-allocated handle scope.
v8::HandleScope handle_scope(isolate);
// Create a new context.
v8::Local<v8::Context> context = v8::Context::New(isolate);
// Enter the context for compiling and running the hello world script.
v8::Context::Scope context_scope(context);
{
// Create a string containing the JavaScript source code.
v8::Local<v8::String> source =
v8::String::NewFromUtf8Literal(isolate, "'Hello' + ', World!'");
// Compile the source code.
v8::Local<v8::Script> script =
v8::Script::Compile(context, source).ToLocalChecked();
// Run the script to get the result.
v8::Local<v8::Value> result = script->Run(context).ToLocalChecked();
// Convert the result to an UTF8 string and print it.
v8::String::Utf8Value utf8(isolate, result);
printf("%s\n", *utf8);
}
{
// Use the JavaScript API to generate a WebAssembly module.
//
// |bytes| contains the binary format for the following module:
//
// (func (export "add") (param i32 i32) (result i32)
// get_local 0
// get_local 1
// i32.add)
//
const char csource[] = R"(
let bytes = new Uint8Array([
0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00, 0x01, 0x07, 0x01,
0x60, 0x02, 0x7f, 0x7f, 0x01, 0x7f, 0x03, 0x02, 0x01, 0x00, 0x07,
0x07, 0x01, 0x03, 0x61, 0x64, 0x64, 0x00, 0x00, 0x0a, 0x09, 0x01,
0x07, 0x00, 0x20, 0x00, 0x20, 0x01, 0x6a, 0x0b
]);
let module = new WebAssembly.Module(bytes);
let instance = new WebAssembly.Instance(module);
instance.exports.add(3, 4);
)";
// Create a string containing the JavaScript source code.
v8::Local<v8::String> source =
v8::String::NewFromUtf8Literal(isolate, csource);
// Compile the source code.
v8::Local<v8::Script> script =
v8::Script::Compile(context, source).ToLocalChecked();
// Run the script to get the result.
v8::Local<v8::Value> result = script->Run(context).ToLocalChecked();
// Convert the result to a uint32 and print it.
uint32_t number = result->Uint32Value(context).ToChecked();
printf("3 + 4 = %u\n", number);
}
}
// Dispose the isolate and tear down V8.
isolate->Dispose();
v8::V8::Dispose();
v8::V8::ShutdownPlatform();
delete create_params.array_buffer_allocator;
return 0;
}
- 编译和运行 调试和发布配置。他们应该输出：
Hello, World!
3 + 4 = 7