Emscripten 的 Web 原生插件
Emscripten 的 Web 原生插件。
阅读时间4 分钟最后更新于 5 天前
Unity 使用 Emscripten 编译器工具链将用 C 和 C++ 编写的 Unity 运行时代码交叉编译为 WebAssembly(也称为 Wasm)。Emscripten 生成小代码,具有加载时间和内存效率,旨在提供关闭原生速度的执行。
Unity 使用 IL2CPP 将 C# 脚本中的 .NET 游戏代码转换为 Wasm。IL2CPP 接受 .NET 字节码并将其转换为相应的 C++ 音频源文件,然后使用 Emscripten 进行编译以将脚本转换为 Wasm。
目标版本
Unity 将 Emscripten 编译器器与 Web 包起,因此不必手动Download。Editor 使用的 Emscripten 版本 Editor 版本而异:
Unity 版本 | 脚本版本 | 支持的原生插件文件格式 |
|---|---|---|
| Unity 2023.2 及更高版本 | Emscripten 3.1.38-Unity | .a, .bc |
| Unity 2022.2 及更高版本 | Emscripten 3.1.8-Unity | .a, .bc |
| Unity 2021.2 及更高版本 | Emscripten 2.0.19.6-Unity | .a, .bc |
| Unity 2019.2 到 2021.1 | 1.38.11-unity | .bc |
| Unity 2018.4 到 Unity 2019.2 | 1.37.40-Unity | .bc |
| Unity 2018.2 到 Unity 2018.4 | 1.37.33Unity | .bc |
注意:
-
以下列表提供了上表中列出的文件格式缩写的扩展:
- GNU 存档 File Format ()
.a - WebAssembly 对象文件()
.o - LLVM Bitcode File Format()
.bc
- GNU 存档 File Format (
-
对于 Emscripten 2.0 之前的 Emscripten 版本,Unity 建议构建插件(类型为
Bitcode的文件)。从 Emscripten 2.0 开始,Unity 建议使用版本.bc插件,这些插件是类型为Wasm Object File的 Wasm Object 文件,捆绑到类型为.o的 GNU 存档文件中。.a
可从位于以下位置的确定 Emscripten 工具链的确切版本的路径:
emscripten-version.txtC:\Program Files\Unity\Hub\Editor\<Editor version>\Editor\数据\PlaybackEngines\WebGLSupport\BuildTools\Emscripten\emscripten\emscripten-版本。txt
使用 Emscripten 编译原生插件
如果要为 Unity 应用程序创建原生 C/C++ 插件,可将 C/C++ 代码与 Project 捆绑(请参阅原生插件),或使用 Emscripten 编译器工具链提前将原生代码版本构建到插件存档。
如果选择预先构建插件代码版本,则应使用 Emscripten 编译器工具链。为了确保 LLVM Binary Format 兼容性,用于编译插件的 Emscripten 版本必须与 Unity 使用的 Emscripten 版本 Match。
通常,插件会编译为Static库存档Format。对于 Unity 2021.2 (Emscripten 2.0) 之前的版本,LLVM Bitcode File Format () 是首选插件 Format。
.bc从 Unity 2021.2 开始,首选插件格式是包含 WebAssembly 对象文件 () 的 GNU 存档 File Format ()。虽然仍然支持早期的 LLVM Bitcode .bc 插件文件,但使用这些文件可能会对编译时间产生负面影响。
.o.aEmscripten 版本标志
如果编译 WebAssembly 对象文件以便与 WebAssembly 2023 或 C/C++ 多线程一起使用,请包含以下 Emscripten 版本标志。如果没有这些标志,代码可能无法与使用 Unity 构建的代码正确 Link。
目标 | 必需的 Emscripten 版本标志 |
|---|---|
| WebAssembly 2023 | |
| C/C++ 原生线程 | |