构建适用于桌面平台的插件

适用于桌面平台的插件是用 C、C++和 Objective C 编写的原生代码库。本页将介绍适用于 Windows、macOS 和 Linux 的插件。有关更多信息，请参阅原生插件的相关文档。

macOS 插件

可以将 macOS 插件部署为捆绑包，如果使用 IL2CPP，则可以部署为松散的 C++ 文件（可以使用 [DllImport(“__Internal”)] 语法进行调用）。有关松散 C++ 插件的更多信息，请参阅适用于 IL2CPP 的 C++ 源代码插件的相关文档。

要使用 XCode 创建捆绑包项目，请打开 XCode 11，选择 File > New > Project__，然后导航到 macOS__ > Framework & Library > Bundle。有关使用 XCode 的更多信息，请参阅 Apple 关于 XCode 的文档。

必须将插件构建为包含 64 架构的通用二进制文件。或者，也可以提供单独的 dylib 文件。 如果使用 C++ (.cpp) 或 Objective-C (.mm) 来实现插件，则必须确保使用 C 链接来声明函数，从而避免名称错用问题。

extern "C"
{
  float FooPluginFunction ();
}

Windows 插件

Windows 上的插件是具有所导出函数的 .dll 文件，如果使用 IL2CPP，则是松散的 C++ 文件。可以使用大多数可以创建 .dll 文件的语言和开发环境来创建插件。必须使用 C 链接来声明任何 C++ 函数，从而避免名称错用问题。

Linux 插件

Linux 上的插件是具有所导出函数的 .so 文件。虽然这些库通常采用 C 或 C++ 编写，但您也可使用任何语言编写。与其他平台一样，必须使用 C 链接来声明所有 C++ 函数以免发生名称错用问题。

管理 Unity 中的插件

在 Unity 中，__Plugin Inspector__ 负责管理插件。要访问 Plugin Inspector，请在 Project 窗口中选择一个插件文件。对于独立平台，可以选择与库兼容的 CPU 架构。对于跨平台插件，必须包含 .bundle 文件（对于 macOS）、.dll 文件（对于 Windows）和 .so 文件（对于 Linux）。Unity 会自动为目标平台选择正确的插件并将该插件包含在播放器中。请参阅有关 Plugin Inspector 的文档以了解更多信息。

通过 C# 使用插件

构建捆绑包后，必须将这个包放在 Unity 项目的 Assets 文件夹中（或特定于架构的适当子目录中）。在 C# 脚本中定义如下所示的函数时，Unity 将按名称查找捆绑包： [DllImport ("PluginName")] private static extern float FooPluginFunction ();

__注意__：PluginName 不应包含库前缀和文件扩展名。例如，插件文件的实际名称在 Windows 上为 PluginName.dll，在 Linux 上为 libPluginName.so。

插件示例