Version: 2021.3
通用 Windows 平台:IL2CPP 脚本后端上的插件
常见问题解答

通用 Windows 平台:IL2CPP 脚本后端上的调试

调试 C# 代码

要使用 IL2CPP 调试 C# 代码,请在构建项目之前启用 Build Settings 中的 Script Debugging__,并在 Player 设置 或清单中启用 InternetClientInternetClientServer__ 和 PrivateNetworkClientServer 功能。在先前的构建之上进行构建时,清单不会被覆盖,因此如果想要更改功能,则需要从 Visual Studio 清单编辑器执行此操作。

调试过程与任何其他 Unity 平台相同。想了解更多相关信息,请参阅在 Unity 中调试 C# 代码

调试生成的 C++ 代码

除了调试 C# 代码之外,还可以使用 Visual Studio 调试生成的 C++ 代码。

生成的 C++ 代码中的类和方法命名

IL2CPP 类如下所示:<ClassName>_t#number,其中的 <ClassName> 是类的普通名称,而 #number 是唯一的类型编号。某些核心类型不存在 #number。例如:

String_t
Object_t
Type_t
Char_t34
StringBuilder_t26
GuidParser_t1539

IL2CPP 方法如下所示:<ClassName>_<MethodName>_m#number,其中的 <ClassName> 是声明类型的方法的普通类名,<MethodName> 是普通方法名称,而 #number 是唯一的方法编号。例如:

GuidParser_ParseHex_m10003
ConfigurationSection_DoDeserializeSection_m1275
String_Format_m4102
Mathf_Sqrt_m289
Thing_Start_m1

静态字段结构的命名如下所示:<ClassName>_t#number_StaticFields,其中结构名称的第一部分与声明类型相同,例如:

StringBuilder_t26_StaticFields
Thing_t24_StaticFields

此外,在每个类/方法定义上面都有一条 C++ 注释,指出完整的类/方法名称。例如:

// System.String
struct String_t : public Object_t
{
    // System.Int32 System.String::length
    int32_t _length_0;
    // System.Char System.String::start_char
    uint16_t _start_char_1;
};

// System.Text.StringBuilder
struct StringBuilder_t26  : public Object_t
{
    // System.Int32 System.Text.StringBuilder::_length
    int32_t length_1;
    // System.String System.Text.StringBuilder::_str
    String_t* str_2;
    // System.String System.Text.StringBuilder::_cached_str
    String_t* cached_str_3;
    // System.Int32 System.Text.StringBuilder::_maxCapacity
    int32_t maxCapacity_4;
};

// System.Void MyData::.ctor()
extern "C" void MyData_ctor_m0 (MyData_t2 * this, const MethodInfo* method)
{
    ...
}

// Thing
struct Thing_t24 : public MonoBehaviour_t25
{
    // MyData Thing::m_Data
    MyData_t2 * _m_Data_2;
    // System.Text.StringBuilder Thing::m_Builder
    StringBuilder_t26 * _m_Builder_3;
};
struct Thing_t24_StaticFields
{
    // System.Int32 Thing::s_SomeStaticField
    int32_t _s_SomeStaticField_4;
};

观察变量值

调试最重要的部分之一是观察各种变量的值。Visual Studio 允许将鼠标悬停在变量上以将变量添加到监视窗口中,从而通过相对容易的方式观察变量的值。例如:

观察静态字段有点困难。在 IL2CPP 中,静态字段存储在 Il2CppClass 实例本身上。因此,为了观察静态字段,我们首先需要一个指向该类型 Il2CppClass 结构的指针。这些指针位于使用它们的方法的作用域内,但在观察一次之后,指针将在应用程序运行期间保持在相同的内存地址。Il2CppClass 结构具有“static_fields”字段,该字段便是一个指针,指向包含该特定类型的静态字段的内存块。要查看实际值,必须将此指针强制转换为适当的静态字段结构:每种类型都有自己的字段。例如,我们来观察 Thing_t24 类的静态字段:

调查异常

IL2CPP 使用本机 C++ 异常来实现 .NET 异常。当应该抛出某种异常时,IL2CPP 将抛出 Il2CppExceptionWrapper 对象,其定义如下:

struct Il2CppExceptionWrapper
{
    Il2CppException* ex;

    Il2CppExceptionWrapper (Il2CppException* ex) : ex (ex) {}
};

可在监视窗口中轻松调查这些异常对象:

最后,对异常启用调试器中断,从而能够当场捕获异常的来源,这样可能有助于发现问题。为此,请在 Visual Studio 中按 CTRL+ALT+E,并确保在打开的窗口中选中了 C++ Exceptions 复选框:

启用此设置后,只要有异常抛出,Visual Studio 就会自动停止执行:


  • • 2018–10–18 页面已修订

  • 2018.2 版中添加了在通用 Windows 平台上为 IL2CPP 进行 C# 调试的功能 NewIn20182

通用 Windows 平台:IL2CPP 脚本后端上的插件
常见问题解答