托管插件
有关使用托管插件的详细信息。
阅读时间8 分钟最后更新于 6 天前
Managed 插件是在 Unity 外部创建并编译到使用 Visual Studio 等工具的动态链接库 (DLL) 中的 .NET 程序集。
这是与标准 C# 脚本不同的过程,Unity 将这些脚本作为音频源文件存储在 Unity Project的 Assets Folder。Unity 会在标准 C# 脚本发生更Change时编译这些脚本,而 DLL 是预编译的,不会Change。您可以将编译的 .dll 文件添加到项目中,并以与标准脚本相同的方式将其包含的类附加到游戏对象。
有关 C# 托管代码的更多信息,请参阅 Microsoft 的 What is Managed Code? 文档。
Managed插件仅包含 .NET 代码,这意味着它们无法访问 .NET 库不Support的AnyFeatures。但是,Unity 用于编译脚本的标准 .NET 工具可以访问 Managed 代码。
在 Unity 中使用 DLL When,必须完成比使用脚本When更多的步骤。但是,在某些情况下,您可能会查找创建 DLL 文件并将其添加到 Unity Project会很有帮助,例如:
- 您想要在代码中使用 Unity 不Support的编译器。
- 要在 .dll 文件中添加第三方 .NET 代码。
- 您希望向 Unity 提供没有音频源码的代码。
Page 介绍可用于创建 Managed 插件的 General 方法,以及如何使用 Visual Studio 创建 Managed 插件和设置调试会话。
创建托管插件
要创建 Managed 插件,您需要创建 DLL。为此,您需要合适的编译器,例如:
并非All生成 .NET 代码的编译器都与 Unity 兼容,因此在对其进行重要工作之前,应使用一些可用代码测试编译器器。有关 Unity 当前支持的 .NET 配置文件的信息,请参阅 .NET 配置文件 Support。
使用于创建 DLL 的方法取决ON DLL 是否包含 Unity API 代码:
-
如果 DLL 包含 Unity API 代码,则需要在编译之前使 Unity 自己的 DLL 可供编译器使用:
-
要查找 Unity DLL,请执行以下操作:
-
ON Windows,转到:
C:\Program Files\Unity\Hub\Editor\<version-number>\Editor\Data\Managed -
ON macOS:
- ON 计算机上查找文件。ON macOS 上的 Unity DLL 的路径为:
Unity.app/Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed - 右键单击 ON
Unity.app - 选择 Show Package Contents(显示包内容)。
- ON 计算机上查找
-
-
Folder 分别包含 All Editor 和 Engine 代码的
Managed和UnityEditor.dll外观程序集。引用它们可以make Editor 或 Engine API 可用于脚本。不要尝试直接引用各个模块程序集,因为不支持这样做。某些命名空间还需要引用 Unity Project 中的编译库(例如UnityEngine.dll)。在 Project Folder 的目录中找到:UnityEngine.UI~\Library\ScriptAssemblies
-
-
如果 DLL 不包含 Unity API 代码,或者您已使 Unity DLL 可用,请按照编译器器的文档编译 DLL 文件。使用编译 DLL 的确切选项取决ON您使用的编译器器。例如,Roslyn 编译器的命令行ON macOS 可能如下所示:
csc
csc /r:/Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed/UnityEngine.dll /target:library /out:MyManagedAssembly.dll /recurse:*.cs在此示例中:
- 使用 选项指定要包含在版本(在本示例中为
/r库)中的库的路径。UnityEngine - 使用 选项指定所需的生成类型;
/target表示 DLL 生成。library - 使用 指定库的名称,在本例中为
/out。MyManagedAssembly.dll - 添加要包含的音频源文件的Name。使用 方法在当前工作目录和 Any 子文件夹中添加所有以
/recurse结尾的文件。生成的 .dll 文件与音频源文件显示在同一文件夹中。.cs
使用托管插件
编译 DLL 后,可以像AnyOther资源一样将 DLL 文件Drag Unity Project。然后,您可以:
- ExpandManaged插件以View库的单独类。
- 将派生自 MonoBehaviour 的Drag到游戏对象上。
- 直接从 Other 脚本使用非 MonoBehaviour 类。

An expanded DLL with the classes visible
使用 Visual Studio 创建 DLL
本节说明:
- 如何将 Simple DLL 示例与 Visual Studio 版本集成
- 如何在 Unity 中为 DLL 准备调试会话。
设置Project
-
Open Visual Studio 并创建一个新建Project。
-
选择 文件 > 新建 > Project > Visual C# > .Net 标准 > 类库 (.NET 标准)。
-
将以下信息添加到库
- Name(名称):命名空间(对于此示例,使用 作为 Name)。
DLLTest - 位置:Project的父件Folder。
- 解决方案名称:Project 的 Folder。
- Name(名称):命名空间(对于此示例,使用
-
make Unity DLL 可用于脚本。在 Visual Studio 中,打开解决方案资源管理器中引用的上下文菜单,然后选择 Add Reference > Browse > 选择文件。
-
选择位于 UnityEngine Folder 中的所需 .dll 文件。
对 DLL 进行编码
- 对于此示例,在 Solution 浏览器中将默认类重命名为 。
MyUtilities - 将其代码替换为:
using System; using UnityEngine;命名空间 DLLTest { public class MyUtilities { public int c; public void AddValues(int a, int b) { c = a + b; } public static int GenerateRandom(int min, int max) { System.随机 rand = 新建 System.随机 (); return rand.Next(min, max); } }}
- 生成Project以Generate DLL 文件及其调试符号。
在 Unity 中调试 DLL
要在 Unity 中为 DLL 设置调试会话:
- 在 Unity 中创建新项目,并将构建的 .dll 文件(例如,)复制到 Assets Folder 中。
<project folder>/bin/Debug/DLLTest.dll - 在 Assets Folder创建一个名为 测试 的 C# Script。
- 将其内容替换为脚本,该脚本将创建在 DLL 中创建的类的新建实例,使用其函数并在控制台窗口中显示输出。例如,要从以上部分为 DLL 创建测试脚本,请复制以下代码:
using UnityEngine;using System.Collections;using DLLTest;public class Test :MonoBehaviour { void Start () { MyUtilities utils = new MyUtilities(); utils.AddValues(2, 3); print("2 + 3 = " + utils.c); } void Update () { print(MyUtilities.GenerateRandom(0, 100)); }}
- 将此脚本附加到Scene中的游戏对象对象,然后单击 播放。
Unity 在控制台窗口中显示 DLL 中的代码输出
编译不安全 C# 代码
不安全 C# 代码是能够直接访问内存的代码。默认情况下不会已启用它,因为编译器器无法验证它不会引入SECURITY风险。
您可能需要使用不安全的代码来执行以下操作:
- 使用指针访问内存。
- 分配原始内存。
- 使用指针调用方法。
要启用对编译不安全 C# 代码的支持,转到 Edit > > Player > Other Settings 并启用 Allow Unsafe Code。
项目设置
?
有关更多信息,请参阅 Microsoft 的不安全代码文档。