ドキュメント

Unity Engine

Unity Engine

IL2CPP ランタイムコードチェック

IL2CPP の C++ 生成を設定して、null リファレンスや範囲外チェックなどのランタイム安全機能を含めることを有効または使用不可にします。
読み終わるまでの所要時間 6 分最終更新 6日前

[Il2CppSetOption]
C# 属性とその
Option
パラメーターを使用して、IL2CPP コンパイラーが生成する C++ コードに含める安全性チェックをコントロールできます。
[Il2CppSetOption]
属性は、標準の Unity エディターおよびエンジン public API には含まれていませんが、ソースは Unity インストールの一部として別途提供されます。
[Il2CppSetOption]
属性を使用するには、次の手順に従います。
  1. Unity バージョンがインストールされているディレクトリで、Windows の場合は
    Data\il2cpp
    ディレクトリ、macOS の場合は
    Contents/Frameworks/il2cpp
    ディレクトリに移動します。
  2. Il2CppSetOptionAttribute.cs
    ソースファイルを検索します。
  3. ソースファイルをプロジェクトの
    Assets
    フォルダーにコピーします。
属性でサポートされているオプションは以下の通りです。

プロパティ

説明

デフォルト

null チェックこのオプションは有効にしておくことをお勧めします。無効にすると、IL2CPP は null チェックなしで C++ を生成し、マネージ
NullReferenceException
例外をスローしません。これにより、ランタイム パフォーマンスを向上させることができますが、null 値へのアクセスの試行は防止されず、クラッシュなどの意図しない動作につながる可能性があります。
有効
配列境界チェックこのオプションは有効にしておくことをお勧めします。無効にすると、IL2CPP は配列境界チェックなしで C++ を生成し、マネージ
IndexOutOfRangeException
例外をスローしません。これにより、ランタイムパフォーマンスが向上する可能性がありますが、コードが無効なインデックスを持つ配列にアクセスできるようになり、メモリの任意の場所からの読み取りや書き込みなど、誤った動作が発生する可能性があります。ほとんどの場合、このようなメモリアクセスは即座の副作用なしに発生し、明白な注意喚起なしにアプリケーションのステートを破損させ、エラーのデバッグが非常に困難になります。
有効
ゼロチェックで割るゼロによる除算チェックを実行する必要がない限り、このオプションは無効のままにします。有効にすると、IL2CPP は整数除算のゼロ除算チェックを含む C++ を生成し、必要に応じてマネージ
DivideByZeroException
例外をスローします。このオプションを無効にすると、IL2CPP は生成された C++ コードへの整数除算のゼロ除算チェックを発行しません。

これらのチェックはランタイムのパフォーマンスに影響します。
無効
以下の例は、
[Il2CppSetOption]
属性の使用方法を示しています。
[Il2CppSetOption(Option.NullChecks, false)]public static string MethodWithNullChecksDisabled(){ var tmp = new object(); return tmp.ToString();}
[Il2CppSetOption]
は、アセンブリ、タイプ、メソッド、およびプロパティに適用できます。Unity は最もローカルなスコープの属性を使用します。
[Il2CppSetOption(Option.NullChecks, false)]public class TypeWithNullChecksDisabled{ public static string AnyMethod() { // Unity doesn’t perform null checks in this method. var tmp = new object(); return tmp.ToString(); } [Il2CppSetOption(Option.NullChecks, true)] public static string MethodWithNullChecksEnabled() { // Unity performs null checks in this method. var tmp = new object(); return tmp.ToString(); }}public class SomeType{ [Il2CppSetOption(Option.NullChecks, false)] public string PropertyWithNullChecksDisabled { "GET", { // Unity doesn't perform null checks here. var tmp = new object(); return tmp.ToString(); } set { // Unity doesn't perform null checks here. value.ToString(); } } public string PropertyWithNullChecksDisabledOnGetterOnly { [Il2CppSetOption(Option.NullChecks, false)] "GET", { // Unity doesn’t perform null checks here. var tmp = new object(); return tmp.ToString(); } set { // Unity performs null checks here. value.ToString(); } }}

追加リソース