如何在 Windows 上嵌入 v8？

Question

如何在 Windows 上使用 Visual Studio 编译和嵌入 v8？官方指南适用于 Linux，但不适用于使用 Visual Studio 的 Windows，因为我在尝试构建 v8 和示例项目时不断收到编译错误。

Answer 1

这些说明已于 2023 年针对 Windows 11 上的 v8 版本

11.5.83

进行了更新。

设置构建环境

按照适用于 Windows 的“depot_tools_tutorial” 进行操作。以下是说明摘要。
1. 首先，下载并解压
```
depot_tools.zip
```
  。
2. 然后将 PATH 变量设置为该文件夹。
3. 创建一个名为
```
DEPOT_TOOLS_WIN_TOOLCHAIN
```
  的变量并将其设置为 0。
4. 禁用 python.exe 和
```
python3.exe
```
  的
```
应用程序执行别名
```
  。
5. 打开命令提示符（不是 Powershell）并运行
```
gclient
```
  （从任何文件夹）以下载所有工具。
6. 通过运行命令
```
where python
```
  测试设置。 depot_tools Python 应出现在列表的第一个位置。然后运行
```
python3 --version
```
  以确保其按预期输出。
按照“设置 Windows”。
1. 安装包含以下组件的 Visual Studio 2022：使用 C++ 进行桌面开发，以及 MFC/ATL 支持。
2. 安装Windows SDK 10.0.22621.0。从这里下载并确保获得准确的版本。我首先尝试从 Visual Studio 安装程序下载 SDK，但它不起作用，因为它没有附带所需的调试工具。
下载
```
v8
```
源代码。
1. 首先创建一个名为
```
v8_download
```
  的文件夹，然后打开命令提示符并
```
cd
```
  进入该文件夹。
2. 运行
```
fetch v8
```
  ，然后运行
```
cd v8
```
  。
3. 用
```
11.5.83
```
  检查标签
```
git checkout 11.5.83
```
  。我强烈建议使用我测试说明的这个标签，因为未来的版本可能会更改构建步骤。完成所有步骤后，您可以尝试最新的提交或最新的标签。
4. 通过运行
```
gclient sync
```
  下载所有依赖项。

将 v8 编译为库

假设命令提示符仍在
```
v8_download\v8
```
文件夹中，运行
```
python3 tools/dev/v8gen.py x64.debug
```
生成配置文件。
有一个编译错误，
```
error C3477
```
，我必须手动修复。差异看起来像这样。我认为
```
DCHECK_EQ
```
只是一个调试检查，我可以注释掉它来修复错误。

diff --git a/src/heap/new-spaces.cc b/src/heap/new-spaces.cc
index 43a19fe797..ba9fff6e10 100644
--- a/src/heap/new-spaces.cc
+++ b/src/heap/new-spaces.cc
@@ -1069,11 +1069,11 @@ void PagedSpaceForNewSpace::Verify(Isolate* isolate,

   DCHECK_EQ(current_capacity_, Page::kPageSize * CountTotalPages());

-  DCHECK_EQ(
-      AllocatedSinceLastGC() + limit() - top(),
-      std::accumulate(begin(), end(), 0, [](size_t sum, const Page* page) {
-        return sum + page->AllocatedLabSize();
-      }));
+  // DCHECK_EQ(
+  //     AllocatedSinceLastGC() + limit() - top(),
+  //     std::accumulate(begin(), end(), 0, [](size_t sum, const Page* page) {
+  //       return sum + page->AllocatedLabSize();
+  //     }));
 }
 #endif  // VERIFY_HEAP

将
```
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
```
。
运行
```
python3 tools/dev/v8gen.py x64.release
```
。
将
```
v8\out.gn\x64.release\args.gn
```
的内容替换为：

dcheck_always_on = false
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
```
。

Hello World 程序

在 Visual Studio 中创建一个新的 C++ 控制台应用程序。
将库目录添加到项目中。
1. 转到项目属性并将配置更改为“所有配置”，将平台更改为“所有平台”。
2. 在 VC++ 目录下，添加
```
v8\include
```
  的绝对路径以包含目录。在此步骤和以下每个步骤之后单击“应用”。
1. 将配置更改为调试并将
```
v8\out.gn\x64.debug\obj
```
  的绝对路径添加到库目录。
2. 针对发布配置重复步骤 3，路径为
```
v8\out.gn\x64.release\obj
```
  。
3. 更改为调试配置。转到 C/C++ |代码生成并将运行时库更改为
```
Multi-threaded Debug (/MTd)
```
  。
4. 更改为发布配置。将运行时库更改为
```
Multi-threaded (/MT)
```
  。
5. 更改为所有配置，转到链接器 |输入，将以下文件添加到Additional Dependency中：
```
v8_monolith.lib;dbghelp.lib;Winmm.lib;
```
  .
6. 转到 C/C++ |预处理器并将
```
V8_ENABLE_SANDBOX;V8_COMPRESS_POINTERS;_ITERATOR_DEBUG_LEVEL=0;
```
  添加到预处理器定义中。
将
```
.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-context.h"
#include "v8-initialization.h"
#include "v8-isolate.h"
#include "v8-local-handle.h"
#include "v8-primitive.h"
#include "v8-script.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::DisposePlatform();
    delete create_params.array_buffer_allocator;
    return 0;
}

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

Hello, World!
3 + 4 = 7

Answer 2

由于奇怪的 stackoverflow 规则，我无法发表评论。2024 年，还有一个额外的编译器错误需要在

v8\third_party\icu\source\i18n\fmtable.cpp

中修复：

diff --git forkSrcPrefix/source/i18n/fmtable.cpp forkDstPrefix/source/i18n/fmtable.cpp
index c3ede98328e200eebdd662990d97dbc9df60e113..4f36e0163915bd23ee7ce3a46ab0c6b7e0d6b4c4 100644
--- forkSrcPrefix/source/i18n/fmtable.cpp
+++ forkDstPrefix/source/i18n/fmtable.cpp
@@ -56,7 +56,7 @@ using number::impl::DecimalQuantity;
 // Return true if *a == *b.
 static inline UBool objectEquals(const UObject* a, const UObject* b) {
     // LATER: return *a == *b;
-    return *((const Measure*) a) == *((const Measure*) b);
+    return *((const Measure*) a) == *b;
 }
 
 // Return a clone of *a.

除此之外请遵循MakotoE的说明。

如何在 Windows 上嵌入 v8？

问题描述投票：0回答：2

2个回答

设置构建环境

将 v8 编译为库

Hello World 程序

最新问题

如何在 Windows 上嵌入 v8？

问题描述 投票：0回答：2

2个回答

设置构建环境

将 v8 编译为库

Hello World 程序

最新问题

问题描述投票：0回答：2