GodotJS

该项目通过利用V8的高性能特性，为Godot 4.x添加了TypeScript/JavaScript支持，将TypeScript愉悦的开发体验引入Godot。

[!注意] 核心功能已实现并基本可用，但仍在测试中。

typescript_intellisence

特性

入门指南

第1步： 下载或克隆仓库到您的Godot引擎源码的modules目录：

cd 您的Godot引擎源码/modules
git clone https://github.com/ialex32x/GodotJS.git

第2步： 将v8的头文件和库文件放入GodotJS目录，或直接从GodotJS-Dependencies下载预构建的v8：

# 下载预构建v8的压缩包
curl https://github.com/ialex32x/GodotJS-Dependencies/releases/download/v8_r6/v8_r6.zip --output 您的下载路径/v8.zip

# 将zip文件解压到您的`GodotJS`目录
# 注意：开关`-o`后面没有空格
7z x -o"您的Godot引擎源码/modules/GodotJS" 您的下载路径/v8.zip

[!注意] 如果您决定自己编译v8，请务必将v8的头文件/库文件放入与预构建v8相同的目录结构中。

模块目录结构如下：

┗━ godot
    ┗━ modules
        ┣━ ...
        ┣━ gltf
        ┣━ GodotJS
        ┃    ┣━ bridge-quickjs
        ┃    ┣━ bridge-v8
        ┃    ┣━ ...
        ┃    ┣━ lws
        ┃    ┗━ v8
        ┃        ┣━ include
        ┃        ┣━ linux.x86_64.release
        ┃        ┣━ macos.arm64.release
        ┃        ┗━ windows.x86_64.release
        ┣━ gridmap
        ┣━ ...

当前使用的v8版本是12.4.254.20。

第3步： 编译并启动Godot编辑器。然后，将TypeScript/JavaScript预设安装到Godot项目中。

[!注意] 由于预构建的v8库是使用VS2022的github runner构建的，如果在链接v8_monolith.lib或libucrt.lib时遇到"未解析的外部符号"错误，可以通过更新到最新版本的MSVC v143工具链、Windows Universal CRT SDK和Visual Studio 2022本身来解决。

可以从GodotJS-Build下载预构建版本的Godot编辑器。 由于GodotJS-Build工作流目前是手动运行的，它可能不是从GodotJS的最新提交构建的。