Windows Store Apps: IL2CPP スクリプティングバックエンドのデバッグ

今のところ IL2CPP では 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

static フィールド構造体は <ClassName>_t#number_StaticFields のようになります。構造名の最初の部分は宣言型と同じです。以下はその例です。

StringBuilder_t26_StaticFields
Thing_t24_StaticFields

また、それぞれのクラス/メソッドの定義の上に完全なクラス/メソッド名がコメントとして付加されています。例えば、

// 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 では、静的フィールドは TypeInfo インスタンスそのものに保管されます。そのため、静的フィールドを 調査するために、最初に、TypeInfo 構造体に同じタイプのポインターを設定する必要があります。これらのポインターは、それを使用するメソッドのスコープ内にありますが、1 度使用した後、アプリケーションが作動している間は同じメモリアドレスに残ります。TypeInfo 構造体には “static_fields” フィールドがあり、それは、特にこのタイプの静的フィールドを含むメモリーブロックを指すポインターです。実際の値を見るために、このポインターは適当な静的フィールド構造体にキャストされる必要があります。例えば、Thing_t24 クラスの静的フィールドを見てみましょう。

例外の検証

IL2CPP では、ネイティブ C++ 例外を使用し、.NET 例外を実装します。例外を発生させる必要があるとき、IL2CPP は Il2CppExceptionWrapper オブジェクトを投げます。それは、以下のように定義されます。

struct Il2CppExceptionWrapper
{
    Il2CppException* ex;

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

これらの例外オブジェクトは、簡単に Watch ウィンドウで確認できます。

最後に、例外処理でデバッガーのブレークを設けておくと便利です。そうすると、例外のソースを、その場で捕らえることができます。そのためには、Visual Studio で CTRL+ALT+E を押し、開いたウィンドウで、C++ Exceptions のチェックボックスがチェックされているのを確認します。

設定が終了すると、Visual Studio は例外が発生するといつでも、自動的に実行を止めます。