c++ - 如何在 Windows 上嵌入 v8?
问题描述
如何在 Windows 上使用 Visual Studio 编译和嵌入 v8?官方指南适用于 Linux,但不适用于带有 Visual Studio 的 Windows,因为我在尝试构建 v8 和示例项目时不断收到编译错误。
解决方案
似乎 v8 的构建过程经常更改。那里有一些教程,但它们似乎都已经过时了。因此,在 Chromium 团队决定再次更改之前,这些步骤应该暂时有效。
获取 depot 工具和 v8 源代码
这些步骤是从这里复制的。
- 卸载 Python。我在 v8 编译器脚本找到错误的 Python 可执行文件而不是软件仓库工具中提供的那个时遇到问题。通过临时卸载 Python 让您的生活更轻松。
- 配置 Visual Studio 和您的开发环境。您需要带有“使用 C++ 进行桌面开发”和“MFC/ATL 支持”组件的 VS2019。您将需要 Windows 10 SDK 和“Windows 调试工具”功能。
- 下载depot_tools 包并将其解压缩到某个地方。
警告:不要从资源管理器中使用拖放或复制粘贴提取,这不会提取隐藏的“.git”文件夹,这是 depot_tools 自动更新所必需的。不过,您可以使用上下文菜单中的“全部提取...”。
- 将 depot_tools 添加到 PATH 的开头(必须在任何 Python 安装之前)。假设您将捆绑包解压缩到
C:\src\depot_tools
,请打开:
控制面板→系统和安全→系统→高级系统设置
如果您具有管理员访问权限,请修改 PATH 系统变量并将其放在C:\src\depot_tools
前面(或至少放在可能已经有 Python 或 Git 副本的任何目录的前面)。
如果你没有管理员权限,你可以添加一个用户级别的 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 Studio\2019\Professional
Visual Studio 2019。
- 从 cmd.exe shell,运行命令
gclient
。在第一次运行时,gclient 将安装使用代码所需的所有 Windows 特定位,包括 msysgit 和 python。
- 如果您从非 cmd shell(例如 cygwin、PowerShell)运行 gclient,它可能看起来运行正常,但 msysgit、python 和其他工具可能无法正确安装。
- 如果您在首次运行 gclient 时看到文件系统出现奇怪错误,您可能需要禁用 Windows 索引。
打开命令提示符并键入
where python
并确认 depot_toolspython.bat
位于任何python.exe
. 未能确保这一点可能会导致使用 gn 时过度构建。App Execution Aliases 可能与系统上的其他 python 安装冲突,因此禁用这些,
python.exe
并python3.exe
打开控制面板的 App execution aliases 部分并取消选中这两个指向 App Installer 旁边的框。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",
]
}
这是为了消除有关将 bool 与 int 进行比较的警告。希望他们知道自己在做什么。
- 运行
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++ 目录下,将绝对路径添加
v8\include
到包含目录。在此步骤之后和以下每个步骤之后单击应用。 - 将配置更改为调试并将绝对路径添加
v8\out.gn\x64.debug\obj
到库目录。 - 对 Release 配置重复步骤 3,路径为
v8\out.gn\x64.release\obj
. - 更改为所有配置,转到链接器 | 输入,并将以下文件添加到附加依赖项:
v8_monolith.lib;dbghelp.lib;Winmm.lib;
. - 转到 C/C++ | 预处理器并添加
V8_COMPRESS_POINTERS;_ITERATOR_DEBUG_LEVEL=0;
到预处理器定义。 - 更改为调试配置。转到 C/C++ | 代码生成并将运行时库更改为多线程调试 (/MTd)。
- 更改为发布配置。将运行时库更改为多线程 (/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
推荐阅读
- html - 使用 CSS,有没有办法确定 HTML 元素是否具有属性集?
- typescript - ngrx 8 createAction 语法
- python - 如何从python中的列表中获取随机元素?
- sql - 具有多个字段的搜索函数存储过程未返回预期结果
- python - 如何连接到托管在私有树莓派服务器上的远程 MySQL 数据库?
- postgresql - 如何在 AWS Aurora postgres 中终止长时间运行的查询
- css - 当用户在功能性反应组件中使用触摸屏时,用按钮隐藏 div
- r - 与 R 中的条件重复
- python-3.x - RNNLanguageModel 的 forward 方法的作用是什么?
- docker - GitLab CD 工作流将 Docker 应用程序部署到登台和生产中