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

本页面将介绍适用于桌面平台 (Windows/Mac OS X/Linux) 的原生代码插件。

构建适用于 Mac OS X 的插件

在 Mac OSX 上，以捆绑包的形式部署插件。可使用 XCode 按以下方法创建捆绑包项目：选择 File > NewProject…，然后选择 Bundle > Carbon/Cocoa Loadable Bundle__（使用 XCode 3）或 OS X__ > Framework & Library > __Bundle__（使用 XCode 4）

如果使用 C++ (.cpp) 或 Objective-C (.mm) 来实现该插件，则必须确保使用 C 链接来声明函数以免发生名称错用问题。

extern "C" {
  float FooPluginFunction ();
}

构建适用于 Windows 的插件

Windows 上的插件是具有导出函数的 DLL 文件。实际上，任何可创建 DLL 文件的语言或开发环境均可用于创建插件。 与 Mac OSX 一样，应使用 C 链接来声明所有 C++ 函数以免发生名称错用问题。

构建适用于 Linux 的插件

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

32 位和 64 位库

对于需要 32 位和/或 64 位插件的问题，处理方式因平台而异。

Windows 和 Linux

在 Windows 和 Linux 上，可以手动管理插件（例如，在构建 64 位播放器之前，将 64 位库复制到 Assets/Plugins 文件夹中，在构建 32 位播放器之前，将 32 位库复制到 Assets/Plugins 文件夹中），或者可以将 32 位版本的插件放在 Assets/Plugins/x86 中，将 64 位版本的插件放在 Assets/Plugins/x86_64 中。默认情况下，Editor 将首先查看特定于架构的子目录，如果该目录不存在，则从 Assets/Plugins 根文件夹中复制插件。

请注意，对于通用 Linux 构建，需要使用特定于架构的子目录（在进行通用 Linux 构建时，Editor 不会从 Assets/Plugins 根文件夹中复制任何插件）。

Mac OS X

对于 Mac OS X，应将插件构建为包含 32 位和 64 位架构的通用二进制文件。

使用 C# 中的插件

构建捆绑包后，应将其放在 Unity 项目的 Assets > Plugins 文件夹中（或适当的特定于架构的子目录中）。在 C# 脚本中定义如下所示的函数时，Unity 将按名称查找捆绑包：

[DllImport ("PluginName")]
private static extern float FooPluginFunction ();

请注意，__PluginName__ 不应包含库前缀和文件扩展名。例如，插件文件的实际名称在 Windows 上为 PluginName.dll，在 Linux 上为 libPluginName.so。 请注意，每次更改插件中的代码时，都需要在项目中重新编译脚本，否则插件将没有最新的编译代码。

部署

对于跨平台插件，必须在 Plugins 文件夹中包含 .bundle（对于 Mac）、.dll（对于 Windows）和 .so（对于 Linux）文件。 然后便不需要您执行任何其他操作，Unity 会自动为目标平台选择正确的插件并将其包含在播放器中。

示例

最简单的插件

此插件项目只实现了一些非常基本的操作（打印一个数字，打印一个字符串，将两个浮点数相加，将两个整数相加）。如果这是您的第一个 Unity 插件，此示例可能会有所帮助。 此项目位于此处，其中包含 Windows、Mac 和 Linux 项目文件。

使用 C++ 代码渲染

原生插件接口页面上提供了一个在 Unity 中使用多线程渲染技术的多平台插件示例。