如何在Windows上嵌入v8？

似乎 v8 的构建过程经常变化。那里有一些教程，但它们似乎都过时了。因此，在 Chromium 团队决定再次对其进行更改之前，这些步骤暂时应该有效。

这些步骤是从这里复制的。

1. 卸载 Python。我在 v8 编译器脚本中遇到了问题，找到了错误的 Python 可执行文件，而不是 depot 工具中提供的可执行文件。暂时卸载 Python，让您的生活更轻松。


2. 配置 Visual Studio 和您的开发环境。您需要具有“使用 C++ 进行桌面开发”和“MFC/ATL 支持”组件的 VS2019。您将需要 Windows 10 SDK 和“Windows 调试工具”功能。


3. 下载depot_tools 包并将其解压缩到某处。

警告：不要使用资源管理器中的拖放或复制粘贴提取，这不会提取隐藏的“.git”文件夹，这是 depot_tools 自动更新自身所必需的。不过，您可以使用上下文菜单中的“全部提取...”。

4. 将 depot_tools 添加到 PATH 的开头（必须在任何 Python 安装之前）。假设您将捆绑包解压缩到C:srcdepot_tools，请打开：

控制面板 ？系统和安全 ？系统 ？高级系统设置

如果您具有管理员访问权限，请修改 PATH 系统变量并将其放在C:srcdepot_tools前面（或至少放在可能已经有 Python 或 Git 副本的任何目录的前面）。

如果您没有管理员权限，您可以添加一个用户级别的 PATH 环境变量并放在C:srcdepot_tools前面，但是如果您的系统 PATH 中有 Python，您将不走运。

5. 另外，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 Studio2019ProfessionalVisual Studio 2019。

6. 从 cmd.exe shell，运行命令gclient. 首次运行时，gclient 将安装使用代码所需的所有特定于 Windows 的位，包括 msysgit 和 python。

• 如果您从非 cmd shell（例如，cygwin、PowerShell）运行 gclient，它可能看起来运行正常，但 msysgit、python 和其他工具可能无法正确安装。


• 如果您在第一次运行 gclient 时看到文件系统出现奇怪的错误，您可能需要禁用 Windows 索引。

7. 打开命令提示符并键入where python并确认 depot_toolspython.bat位于python.exe. 在使用 gn 时未能确保这一点可能会导致过度构建。




8. App Execution Aliases 可能与系统上的其他 python 安装冲突，因此禁用它们python.exe并python3.exe通过打开控制面板的 App execution aliases 部分并取消选中这两个旁边指向 App Installer 的框。




9. cd到要存储 v8 的目录并运行mkdir v8 && cd v8 && fetch v8.




10. cd v8和git checkout 9.0.257.19，这是撰写本文时最新的稳定版本。




11. 应用此补丁：

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 进行比较的警告。希望他们知道他们在做什么。

12. 运行gclient sync以获取所有依赖项。

13. 运行python tools/dev/v8gen.py x64.debug。




14. 将内容替换为v8out.gnx64.debugargs.gn：

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",
]
}


15. 运行ninja -C out.gn/x64.debug v8_monolith。




16. 运行python tools/dev/v8gen.py x64.release。




17. 将内容替换为v8out.gnx64.releaseargs.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


18. 运行ninja -C out.gn/x64.release v8_monolith。

19. 在 Visual Studio 中创建一个新的空 C++ 项目。




20. 将库目录添加到项目中。

    
    
    1. 转到您的项目属性并将配置更改为所有配置和平台为 x64。
    
    
    2. 在 VC++ 目录下，将绝对路径添加v8include到包含目录。在此步骤和以下每个步骤之后单击应用。
    
    
    3. 将配置更改为调试并将绝对路径添加v8out.gnx64.debugobj到库目录。
    
    
    4. 对 Release 配置重复步骤 3，路径为v8out.gnx64.releaseobj.
       
    
    
    5. 更改为所有配置，转到链接器 | 输入，并将以下文件添加到附加依赖项：v8_monolith.lib;dbghelp.lib;Winmm.lib;.
    
    
    6. 转到 C/C++ | 预处理器并添加V8_COMPRESS_POINTERS;_ITERATOR_DEBUG_LEVEL=0;到预处理器定义中。
    
    
    7. 更改为调试配置。转到 C/C++ | 代码生成并将运行时库更改为多线程调试 (/MTd)。
    
    
    8. 更改为发布配置。将运行时库更改为多线程 (/MT)。
    
    
    
    



21. 添加一个新main.cpp文件并添加以下代码，它是v8sampleshello-world.cc.

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


22. 编译并运行调试和发布配置。他们应该输出：

// 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
#include
#include
#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 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 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 source =
v8::String::NewFromUtf8Literal(isolate, "'Hello' + ', World!'");
// Compile the source code.
v8::Local script =
v8::Script::Compile(context, source).ToLocalChecked();
// Run the script to get the result.
v8::Local result = script->Run(context).ToLocalChecked();
// Convert the result to an UTF8 string and print it.
v8::String::Utf8Value utf8(isolate, result);
printf("%sn", *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 source =
v8::String::NewFromUtf8Literal(isolate, csource);
// Compile the source code.
v8::Local script =
v8::Script::Compile(context, source).ToLocalChecked();
// Run the script to get the result.
v8::Local result = script->Run(context).ToLocalChecked();
// Convert the result to a uint32 and print it.
uint32_t number = result->Uint32Value(context).ToChecked();
printf("3 + 4 = %un", number);
}
}
// Dispose the isolate and tear down V8.
isolate->Dispose();
v8::V8::Dispose();
v8::V8::ShutdownPlatform();
delete create_params.array_buffer_allocator;
return 0;
}