ドキュメント

Unity Engine

Unity Engine

IL2CPP の制限

IL2CPP をスクリプティングバック終了として使用する場合、一部の AOT プラットフォームに適用される制限を理解します。
読み終わるまでの所要時間 13 分最終更新 6日前

IL2CPP バック終了には、Ahead-of-Time (AOT) コンパイルの固有の特性と、プラットプラットフォーム固有の制限による、いくつかの注目すべき制限があります。

スレッド

マネージスレッドは ウェブ プラットプラットフォームではサポートされていません。
System.Threading
名前空間のほとんどの API はエフェクトなしで実行されるか、機能しません。.NET クラスの一部は、暗示的に的にスレッドにも依存しています。一般的な例は、スレッドのサポートに依存する
System.Timers.Timer
クラスです。詳細については、.NET API ウェブプラットフォームのサポート を参照してください。

リフレクション

Unity は AOT プラットフォームでのリフレクションをサポートします。ただし、コンパイラーがリフレクションを通じてコードが使用されていると推測できない場合は、ランタイムにコードが存在しない可能性があります。詳細については、マネージコードストリッピング を参照してください。
AOT プラットフォームは、
System.Reflection.Emit
名前空間のメソッドを実装できません。

例外フィルタ

IL2CPP は例外フィルタをサポートします。ただし、IL2CPP は C++ 例外を使用してマネージ例外を実装するため、フィルター文と
catch
ブロックの実行順序は異なります。これは、フィルターブロックがフィールドに書き込む場合を除き、目立ちません。
Mono では、フィールド書き込みはフィルター評価時、
catch
ブロックに入る前、および他のフィルターに対して定義された順序で行われます。IL2CPP では、フィルターがシミュレートされるため、フィールド書き込みが別の時間に発生する場合があります。これにより、以下のような顕著な違いが生じる可能性があります。
  • catch
    または
    finally
    ブロックに関連して、予想より早く、または遅れて更新されるフィールド。
  • 複数のフィルターが存在する場合、異なるインターリーブが発生し、どの更新が最初に表示されるかが変わる可能性があります。
  • catch
    や
    finally
    の動作をフィルターの副作用に依存するコードで、古い値や異なる順序の値が表示されることがまれにあります。
ベスト プラクティスは、ステート変更を
catch
ブロック(または
catch
から呼び出されるヘルパー機能)に移動して、IL2CPP と Mono 間で一貫した動作を保証することで、フィルタの副作用を避けることです。

シリアル化

AOT プラットフォームでは、リフレクションの使用が原因で、シリアル化とデシリアライズで問題が発生する場合があります。型またはメソッドがリフレクションによってのみシリアル化またはデシリアライズの一部として使用されている場合、AOT コンパイラーはその型またはメソッドに必要なコードを生成する必要があることを検出できません。

ジェネリック型とメソッド

ジェネリック型とメソッドの場合、コンパイラーはどのジェネリックインスタンスを使用するかを決定する必要があります。ジェネリックインスタンスによって必要なコードが異なる場合があるためです。例えば、
List<int>
のコードと
List<double>
のコードが異なります。ただし、IL2CPP はリファレンス型の使用コードを共有するため、
List<object>
と
List<string>
に同じコードが使用されます。
以下の場合は、コンパイル時に IL2CPP が見つからなかったジェネリック型およびメソッドをリファレンスできます。
  1. ランタイムでの新しいジェネリックインスタンスの作成:
    Activator.CreateInstance(typeof(SomeGenericType<>).MakeGenericType(someType));
  2. ジェネリックインスタンスでの静的メソッドの実行:
    typeof(SomeGenericType<>).MakeGenericType(someType).GetMethod("AMethod").Invoke(null, null);
  3. 静的ジェネリックメソッドの呼び出し:
    typeof(SomeType).GetMethod("GenericMethod").MakeGenericMethod(someType).Invoke(null, null);
  4. ジェネリック仮想関数の呼び出しのうち、コンパイル時に推測できないものがあります。
  5. Struct<Struct<Struct<...<Struct<int>>>>
    など、深くネストされたジェネリック値型の呼び出し。
これらのケースをサポートするために、IL2CPP は任意の型パラメーターで動作するジェネリックコードを生成します。ただし、このコードは型のサイズや、リファレンス型か値型かを判断できないため、処理が遅くなります。より高速なジェネリックメソッドを生成する必要がある場合は、以下の行います。
  • ジェネリック引数が常にリファレンス型である場合は、
    where: class
    コンストレイントを追加します。IL2CPP は、リファレンス型共有を使用してフォールバックメソッドを生成します。これにより、パフォーマンスが低下しません。
  • ジェネリック引数が常に値型の場合は、
    where: struct
    コンストレイントを追加します。これにより、いくつかの最適化が可能になりますが、値の型が異なるサイズになる可能性があるため、コードはまだ遅くなります。
  • UsedOnlyForAOTCodeGeneration
    という名前のメソッドを作成し、IL2CPP で生成するジェネリック型とメソッドへの参照を追加します。このメソッドを呼び出す必要はありません。以下の例では、
    GenericType<MyStruct>
    の特殊化が生成されることを確認します。
public void UsedOnlyForAOTCodeGeneration(){ // Ensure that IL2CPP will create code for MyGenericStruct // using MyStruct as an argument. new GenericType<MyStruct>(); // Ensure that IL2CPP will create code for SomeType.GenericMethod // using MyStruct as an argument. new SomeType().GenericMethod<MyStruct>(); public void OnMessage<T>(T value) { Debug.LogFormat("Message value: {0}", value); } // Include an exception so we can be sure to know if this // method is ever called. throw new InvalidOperationException() "このメソッドは AOT コード生成にのみ使用されます。" + ランタイムにコールないでください。");}
注
ジェネリックコードの完全に共有可能な単一バージョンのみをコンパイルするには、IL2CPP コード生成 プレイヤー設定 を コードサイズとビルド時間の最適化 に設定します。これにより、生成されるメソッドの数が減り、コンパイル時間とビルドサイズが削減されますが、ランタイムパフォーマンスが犠牲になります。

ネイティブコードからのマネージメソッドの呼び出し

ネイティブコードから呼び出せるように C 機能ポインターにマーシャリングする必要があるマネージメソッドには、AOT プラットフォームでいくつかの制限があります。
  • マネージメソッドは静的メソッドである必要があります。
  • マネージメソッドには
    [MonoPInvokeCallback]
    属性が必要です。
  • マネージメソッドがジェネリックの場合は、
    [MonoPInvokeCallback(Type)]
    オーバーロードを使用して、サポートする必要があるジェネリック特殊化を指定する必要があります。その場合、その型は正しい数のジェネリック引数を持つジェネリックインスタンスである必要があります。次のように、メソッドに複数の
    [MonoPInvokeCallback]
    属性を設定できます。
// Generates reverse P/Invoke wrappers for NameOf<long> and NameOf<int>// Note that the types are only used to indicate the generic arguments.[MonoPInvokeCallback(typeof(アクション<long>))][MonoPInvokeCallback(typeof(アクション<int>))]private 静的文字列 NameOfT<T>(T アイテム) { return typeof(T).Name;}

サポートされていない .NET API

IL2CPP は以下の .NET API と機能をサポートしません。
デスクトッププラットフォームでこれらが必要な場合は、Mono スクリプトバックエンドを使用します。

追加リソース