文档

Unity 引擎

Unity 引擎

托管插件

有关使用托管插件的详细信息。
阅读时间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 可供编译器使用:
    1. 要查找 Unity DLL,请执行以下操作:
      • ON Windows,转到:
        C:\Program Files\Unity\Hub\Editor\<version-number>\Editor\Data\Managed
      • ON macOS:
        1. ON 计算机上查找
          Unity.app
          文件。ON macOS 上的 Unity DLL 的路径为:
          /Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed
        2. 右键单击 ON
          Unity.app
        3. 选择 Show Package Contents(显示包内容)。
    2. Managed
      Folder 分别包含 All Editor 和 Engine 代码的
      UnityEditor.dll
      和
      UnityEngine.dll
      外观程序集。引用它们可以make Editor 或 Engine API 可用于脚本。不要尝试直接引用各个模块程序集,因为不支持这样做。某些命名空间还需要引用 Unity Project 中的编译库(例如
      UnityEngine.UI
      )。在 Project Folder 的目录中找到:
      ~\Library\ScriptAssemblies
  • 如果 DLL 不包含 Unity API 代码,或者您已使 Unity DLL 可用,请按照编译器器的文档编译 DLL 文件。使用编译 DLL 的确切选项取决ON您使用的编译器器。例如,Roslyn 编译器的命令行
    csc
    ON macOS 可能如下所示:
csc /r:/Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed/UnityEngine.dll /target:library /out:MyManagedAssembly.dll /recurse:*.cs
在此示例中:
  • 使用
    /r
    选项指定要包含在版本(在本示例中为
    UnityEngine
    库)中的库的路径。
  • 使用
    /target
    选项指定所需的生成类型;
    library
    表示 DLL 生成。
  • 使用
    /out
    指定库的名称,在本例中为
    MyManagedAssembly.dll
    。
  • 添加要包含的音频源文件的Name。使用
    /recurse
    方法在当前工作目录和 Any 子文件夹中添加所有以
    .cs
    结尾的文件。生成的 .dll 文件与音频源文件显示在同一文件夹中。

使用托管插件

编译 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

  1. Open Visual Studio 并创建一个新建Project。
  2. 选择 文件 > 新建 > Project > Visual C# > .Net 标准 > 类库 (.NET 标准)。
  3. 将以下信息添加到库
    • Name(名称):命名空间(对于此示例,使用
      DLLTest
      作为 Name)。
    • 位置:Project的父件Folder。
    • 解决方案名称:Project 的 Folder。
  4. make Unity DLL 可用于脚本。在 Visual Studio 中,打开解决方案资源管理器中引用的上下文菜单,然后选择 Add Reference > Browse > 选择文件。
  5. 选择位于 UnityEngine Folder 中的所需 .dll 文件。

对 DLL 进行编码

  1. 对于此示例,在 Solution 浏览器中将默认类重命名为
    MyUtilities
    。
  2. 将其代码替换为:
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); } }}
  1. 生成Project以Generate DLL 文件及其调试符号。

在 Unity 中调试 DLL

要在 Unity 中为 DLL 设置调试会话:
  1. 在 Unity 中创建新项目,并将构建的 .dll 文件(例如,
    <project folder>/bin/Debug/DLLTest.dll
    )复制到 Assets Folder 中。
  2. 在 Assets Folder创建一个名为 测试 的 C# Script。
  3. 将其内容替换为脚本,该脚本将创建在 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)); }}
  1. 将此脚本附加到Scene中的游戏对象对象,然后单击 播放。
Unity 在控制台窗口中显示 DLL 中的代码输出

编译不安全 C# 代码

不安全 C# 代码是能够直接访问内存的代码。默认情况下不会已启用它,因为编译器器无法验证它不会引入SECURITY风险。
您可能需要使用不安全的代码来执行以下操作:
  • 使用指针访问内存。
  • 分配原始内存。
  • 使用指针调用方法。
要启用对编译不安全 C# 代码的支持,转到 Edit >
项目设置

?

> Player > Other Settings 并启用 Allow Unsafe Code。
有关更多信息,请参阅 Microsoft 的不安全代码文档。

其他资源