ドキュメント

Unity Engine

Unity Engine

マネージコードストリッピングと Unity リンカー

ストリッピング前に Unity リンカーがコードの要素を分析し、マークする方法を理解します。
読み終わるまでの所要時間 9 分最終更新 6日前

Unity のビルドプロセスでは、Unity リンカーと呼ばれるツールを使用してマネージコードを削除します。Unity リンカーは、Unity で動作するようにカスタマイズされた IL リンカーのバージョンです。Unity エンジン専用の Unity リンカーのカスタムパーツは、一般に公開されていません。
Unity リンカーは、マネージコードストリッピングと、エンジンコードストリッピング (IL2CPP スクリプティングバック終了を通じて使用可能な別のプロセスで、未使用のエンジンコードを削除する) の一部の処理の両方を担当します。詳細については、「
PlayerSettings.StripEngineCode
」を参照してください。

Unity リンカーによるアセンブリの削除方法

Unity プロジェクトをビルドすると、ビルドプロセスによって C# コードが Common Intermediate Language (CIL) と呼ばれる .NET バイトコード形式にコンパイルされます。Unity はこの CIL バイトコードをアセンブリと呼ばれるファイルにパッケージ化します。プロジェクトで使用するプラグインの .NET Framework ライブラリと C# ライブラリも、CIL バイトコードのアセンブリとして事前にパッケージ化されています。
マネージコードストリッピングの目的では、アセンブリは次のように分類されます。
  • .NET クラスライブラリアセンブリ:
    mscorlib.dll
    や
    System.dll
    などの Mono クラスライブラリや、
    netstandard.dll
    などの .NET クラスライブラリファサードアセンブリが含まれます。
  • プラットフォームSDKアセンブリ:プラットプラットフォーム SDK 専用のマネージアセンブリが含まれます。例えば、ユニバーサル Windows プラットフォーム (UWP) SDK の一部である
    windows.winmd
    アセンブリなどです。
  • Unity エンジンモジュールアセンブリ:
    UnityEngine.Core.dll
    など、Unity エンジンを構成するマネージアセンブリが含まれます。
  • プロジェクトアセンブリ:以下のようなプロジェクト固有のアセンブリが含まれます。
    • Assembly-CSharp.dll
      などのスクリプトアセンブリ。
    • プリコンパイルされたアセンブリ
    • アセンブリ定義アセンブリ。
    • パッケージアセンブリ。
通常、プロジェクトのアセンブリのうち、これらのカテゴリに当てはまらないものは Unity リンカーによって処理されず、 プレイヤービルド から除外されます。
ビルド中、Unity リンカーは適用可能なすべてのタイプのアセンブリを処理し、以下の処理を行います。
  1. アセンブリタイプと設定済みコードストリッピングレベルに適用されるルートマーキング規則に従って、ルートタイプ、メソッド、プロパティー、およびフィールドをマークします。
  2. 識別するためにマークしたルートを分析し、該当する依存関係マーキング規則に従って、これらのルートが依存するマネージコードをマークします。
  3. アプリケーションコードから実行パスで到達不能としてマークされていない残りのコードをアセンブリから削除します。

メソッド本体の編集

高ストリッピングレベルでは、Unity リンカーがメソッド本体を編集してコードサイズをさらに削減します。Unity リンカーは、.NET クラスライブラリのメソッド本体のみを編集します。
Unity リンカーは、以下の方法でメソッドボディを編集できます。
  • 到達不能分岐の削除: ステートメントブロックを
    if
    し、現在ターゲットプラットフォームに到達できない
    System.Environment.OSVersion.Platform
    をチェックします。
  • フィールドのみにアクセスするインラインメソッド: フィールドを取得または設定するメソッドの呼び出しを、そのフィールドへの直接アクセスに置き換えます。これにより、多くの場合、メソッドを完全に取り除くことができます。Mono スクリプティングバック終了を使用する場合、Unity リンカーは、フィールドの可視性性に基づいて、メソッドの呼び出し元が直接フィールドにアクセスできる場合にのみこの変更を行います。IL2CPP では可視性規則は適用されないため、Unity リンカーが必要に応じて変更を行います。
  • const
    値のみを返すインラインメソッド。
  • 空で
    void
    return type.を持つメソッドの呼び出しを削除する
  • try-finally
    ブロックが空のときに、
    finally
    ブロックを削除します。空の呼び出しを削除すると、空の
    finally
    ブロックが作成される可能性があります。メソッド編集中にこれが発生すると、Unity リンカーは
    try-finally
    ブロック全体を削除します。これが発生する 1 つのシナリオは、コンパイラーが
    Dispose
    を呼び出すために
    foreach
    ループの一部として
    try-finally
    ブロックを生成する場合です。
注
メソッド本体の編集後、アセンブリのソースコードがアセンブリ内のコンパイル済みコードと一致しなくなり、デバッグがより難しくなる可能性があります。

追加リソース