通用 Windows 平台：IL2CPP 脚本后端上的插件

通用 Windows 平台的插件模型与其他 Unity 平台（例如 Windows 独立平台）类似。

托管插件

默认情况下，IL2CPP 以 .NET 2.0 API 兼容性级别为目标。这意味着，它不支持以 .NET 4.5 为目标或使用任何 Windows 运行时 API 的托管插件。使用此兼容性级别时，所有托管插件必须以 .NET 4.5 或同等 API 为目标。如果要解除这些限制，可在 Player 设置中切换到 .NET 4.6 API 兼容性级别。

注意：.Net 3.5 脚本运行时已弃用，但可用于 Unity 2018.3 和 2018.4 LTS。请迁移项目或使用 .NET 4.x 运行时创建新项目。

IL2CPP 脚本后端表现出与 Unity Editor 或独立平台播放器完全相同的 .NET API 表面，因此可以使用相同的插件而无需针对通用 Windows 平台的不同 .NET API 来编译单独的版本。

原生插件

IL2CPP 脚本后端支持通过 P/Invoke 机制使用原生插件。也就是说，可通过指定原生函数原型再调用该函数来直接从 C# 代码调用原生插件。例如：

[DllImport("MyPlugin.dll")]
private static extern int CountLettersInString([MarshalAs(UnmanagedType.LPWSTR)]string str);

private void Start()
{
    Debug.Log(CountLettersInString("Hello, native plugin!"));
}

此类函数在 MyPlugin.dll 内的实现如下所示：

extern "C" __declspec(dllexport)
int __stdcall CountLettersInString(wchar_t* str)
{
    int length = 0;
    while (*str++ != nullptr)
        length++;
    return length;
}

P/Invoke 编组规则与官方 .NET 编组规则一致，但少数不受支持的类型除外：

• AnsiBStr
• Currency
• SAFEARRAY
• IDispatch
• TBStr
• VBByRefStr

在 x86 上，P/Invoke 函数的默认调用约定为 __stdcall。

可通过两种方式编写原生插件：预编译的 DLL 或 C++ 源代码。

预编译的原生插件

对预编译的原生插件进行 P/Invoke 调用的工作原理是在运行时加载 DLL，找到函数入口点，然后调用它。必须针对目标 CPU 架构的适当 Windows SDK 编译这些 DLL。添加到 Unity 项目时，还必须在 Plugin Inspector 中配置这些 DLL。

C++ 源代码原生插件

可以将 C++ (.cpp) 代码文件直接添加到 Unity 项目中作为 Plugin Inspector 中的插件。如果配置为与通用 Windows 平台和 IL2CPP 脚本后端兼容，这些 C++ 文件将与从托管程序集生成的 C++ 代码一起编译：

由于函数与生成的 C++ 代码链接在一起，所以没有单独的 DLL 可进行 P/Invoke 调用。因此，可以使用“__Internal”关键字代替 DLL 名称，从而使 C++ 链接器负责解析函数，而不是在运行时加载函数：

[DllImport("__Internal")]
private static extern int CountLettersInString([MarshalAs(UnmanagedType.LPWSTR)]string str);

由于调用由链接器解析，因此在托管端的函数声明中发生错误将产生链接器错误，而不是运行时的错误。这也意味着，在运行时不需要进行动态加载，而直接调用函数。这种方式显著降低了 P/Invoke 调用的开销。

P/Invoke 限制

在通用 Windows 平台上，无法在使用 IL2CPP 脚本后端时指定 dll 名称（如“kernelbase.dll”）来对特定系统库进行 P/Invoke 调用。尝试对项目外部的任何 DLL 进行 P/Invoke 调用将导致运行时出现 DllNotFoundException。

但是，仍然可以通过指定“**Internal”关键字而不是 DLL 名称来对这些系统函数进行 P/Invoke 调用，这会使链接器在构建时解析函数。

另请参阅

Plugin Inspector

• • 2018–08–03 页面已修订但未经编辑审查
  
• 在 2018.3 版中已弃用 .NET 3.5 脚本运行时