通用 Windows 平台：IL2CPP 脚本后端上的插件
The plugin model for Universal Windows Platform is similar to other Unity platforms (such as Windows standalone).
托管插件
By default, IL2CPP targets .NET 2.0 API compatiblity level. That means it does not support managed plugins targeting .NET 4.5 or consuming any of Windows Runtime APIs. All managed plugins must be targeting .NET 4.5 or equivalent API when using this compatiblity level. You can switch to .NET 4.6 API compatibilty level in Player settings if you wish to lift these restrictions.
Note The .Net 3.5 scripting runtime is deprecated, but it will be available for Unity 2018.3 and 2018.4 LTS. Please migrate or start new Projects with the .NET 4.x runtime.
IL2CPP scripting backend exposes the exact same .NET API surface as Unity editor or standalone player, so it’s possible to use the same plugins without the need to compile separate versions targetting different .NET API for Universal Windows Platform.
原生插件
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 调用，这会使链接器在构建时解析函数。
另请参阅
-
• 2018–08–03 Page amended with no editorial review
- .NET 3.5 scripting runtime deprecated in 2018.3