ドキュメント

Unity Engine

Unity Engine

Unity リンカーマーキングルールリファレンス

Unity リンカーが各マネージストリッピングレベルで適用するマーキングルールを理解し、コードセンブリのどの部分をストリップするかを決定します。
読み終わるまでの所要時間 7 分最終更新 6日前

Unity リンカーが静的分析を実行するときは、一連のルールに従って、ビルドに必要な CIL バイトコードのどの部分をマークするかを決定します。
  • ルートマーキング規則は、Unity リンカーがビルド内のトップレベルのアセンブリを識別し、保持する方法を決定します。
  • 依存関係マーキング規則は、ルートアセンブリが依存するコードを Unity リンカーがどのように識別して保持するかを決定します。
設定済みマネージストリッピングレベルは、Unity リンカーが使用する一連のルールを変更します。以下のセクションでは、各マネージストリッピングレベルでのマーキングルールについて説明します。

ルート マーキング規則

以下の表は、Unity リンカーが、さまざまなアセンブリリタイプとマネージストリッピングレベルについて、アセンブリ内のトップレベルタイプを識別する方法を示しています。

アセンブリ タイプ

マネージストリッピングレベルでのルートマーキングルール

.NET クラス、プラットフォーム SDK、UnityEngine アセンブリ最小および低:
  • 予防的保存
最低、低、中、高:
  • 任意の
    link.xml
    ファイルで定義された保存
シーンで参照される型を持つアセンブリ最小および低:
  • アセンブリ内のすべてのタイプとメンバー
中レベルおよび高レベル:
  • [RuntimeInitializeOnLoadMethod]
    属性または
    [Preserve]
    属性を持つすべてのメソッド。
  • 任意の
    link.xml
    ファイルで定義された保存
  • プリコンパイル、パッケージ、Unity スクリプト、またはアセンブリ定義アセンブリの MonoBehaviour と ScriptableObject から派生したすべての型。
その他すべて最小限
  • アセンブリ内のすべてのタイプとメンバー
低および中:
  • すべての public 型とそれらの型の public メンバー
中レベルおよび高レベル:
  • [RuntimeInitializeOnLoadMethod]
    属性または
    [Preserve]
    属性を持つすべてのメソッド。
  • 任意の
    link.xml
    ファイルで定義された保存
  • プリコンパイル、パッケージ、Unity スクリプト、またはアセンブリ定義アセンブリの MonoBehaviour と ScriptableObject から派生したすべての型。
テスト最低、低、中、高:
  • [UnityTest]
    属性を持つメソッド、および NUnit.Framework で定義された属性を持つメソッド。

依存関係マーキング規則

Unity リンカーは、アセンブリのルートを特定した後で、それらのルートが依存するコードを識別する必要があります。以下の表は、Unity リンカーが異なるマネージストリッピングレベルでアセンブリ内のルートタイプの依存関係を識別する方法を示しています。

ルール ターゲット

マネージストリッピングレベルでの依存関係マーキング規則

MonoBehaviour最低、低、中、高:
  • Unity リンカーが MonoBehavior 型のすべてのメンバーをマークするときは、その型
ScriptableObject最低、低、中、高:
  • Unity リンカーが ScriptableObject 型のすべてのメンバーをマークするときは、その型
Attributes最小および低:
  • Unity リンカーがアセンブリ、型、またはその他のコード構造体をマークすると、それらの構造体のすべての属性もマークされます。
中レベルおよび高レベル:
  • Unity リンカーがアセンブリ、型、またはその他のコード構造体をマークする場合、属性タイプもマークされている場合にのみ、それらの構造体の属性もマークされます。
デバッグ属性最小および低:
  • スクリプトのデバッグを有効にすると、Unity リンカーは、
    [DebuggerDisplay]
    属性を持つすべてのメンバーをマークします。これらのメンバーを使用するコードパスがない場合も同様です。
中レベルおよび高レベル:
  • Unity リンカーは常に、
    DebuggerDisplayAttribute
    や
    DebuggerTypeProxyAttribute
    などのデバッグ属性を削除します。
.NET Facade クラスライブラリ最低、低、中、高:
  • ファサード アセンブリはランタイムに不要なため削除します。

追加リソース