文档

Unity 引擎

Unity 引擎

将 Static 库编译为 Unity 插件

从 Static 库调用函数。
阅读时间3 分钟最后更新于 6 天前

您可以使用 Emscripten 编译库并使用 Unity 中的库。从封装 C++ 代码的库调用函数,而不是直接从插件目录调用 C++ 代码,可能更加有益。好处包括:
  • 您的代码更容易与 Web Unity Project 集成。
  • 与从 C++ 代码调用函数相比,代码的性能可能更好,特别是对于较大的库。
  • 您可以在各种Projects中重用代码。

在 Unity 中使用Static库的步骤

要编译可使用 Unity 插件的Static库,请执行以下操作:
  1. 下载 Emscripten SDK
  2. 配置所有现有项目脚本
  3. 更新编译器选项
  4. 编译并导入 Static 库文件
  5. 从 C# 脚本调用 Static 库函数

1.Download Emscripten SDK

必须Download与您的 Unity 版本匹配的 Emscripten SDK。
要查找适用于 Unity Version 的 Emscripten 版本,请参阅 Web 原生 Emscripten 插件。
有关下载链接以及有关如何安装 Emscripten SDK 的更多信息,请参阅 Download and install (Emscripten)。

2.ConfigureAny现有Project脚本

Emscripten 可以替代 gcc 或 clang 编译器。如果您有现有的 C/C++ 代码,则需要在 C++ Project中make以下更改:
  • 使用“emcc”作为 C/C++ 编译器
  • 使用“emar”作为 Static 链接器
有关更多信息,请参阅 ON Compiling and running Projects 的 Emscripten 文档。

3.更新编译器选项

如果您的 Unity Project 具有以下 Player Settings(菜单:编辑 >
项目设置

?

> Player)。

属性

描述

启用例外如果此属性设置为 None,请添加编译器选项“-fno-exceptions”。
启用原生 C/C++ 多线程如果已启用属性性,请包含编译器选项“-pthread”。
启用 WebAssembly 2023如果已启用属性性,请包含以下编译器选项:
  • "-fwasm-exceptions"
  • "-sSUPPORT_LONGJMP=wasm"
  • "-mbulk-memory"
  • "-mnontrapping-fptoint"
  • "-msimd128"
  • "-msse4.2"

4.编译并导入Static库文件

编译 Static 库文件,然后将文件导入 Unity Project 的
Assets/Plugins
Folder 文件夹中。
注意
如果没有 Plugins** Folder,则需要创建自己的文件夹。

5.从 Unity C# 脚本调用Static库函数

您可以从 Unity C# 脚本调用Static库函数。调用函数的方式与从 C# 脚本 或 C++ 函数的方式相同。有关示例,请参阅从 Unity C# 脚本调用 C/C++/C# 函数。

其他资源