マネージコードストリッピングと Unity リンカー
ストリッピング前に Unity リンカーがコードの要素を分析し、マークする方法を理解します。
読み終わるまでの所要時間 9 分最終更新 6日前
Unity のビルドプロセスでは、Unity リンカーと呼ばれるツールを使用してマネージコードを削除します。Unity リンカーは、Unity で動作するようにカスタマイズされた IL リンカーのバージョンです。Unity エンジン専用の Unity リンカーのカスタムパーツは、一般に公開されていません。
Unity リンカーは、マネージコードストリッピングと、エンジンコードストリッピング (IL2CPP スクリプティングバック終了を通じて使用可能な別のプロセスで、未使用のエンジンコードを削除する) の一部の処理の両方を担当します。詳細については、「 」を参照してください。
PlayerSettings.StripEngineCodeUnity リンカーによるアセンブリの削除方法
Unity プロジェクトをビルドすると、ビルドプロセスによって C# コードが Common Intermediate Language (CIL) と呼ばれる .NET バイトコード形式にコンパイルされます。Unity はこの CIL バイトコードをアセンブリと呼ばれるファイルにパッケージ化します。プロジェクトで使用するプラグインの .NET Framework ライブラリと C# ライブラリも、CIL バイトコードのアセンブリとして事前にパッケージ化されています。
マネージコードストリッピングの目的では、アセンブリは次のように分類されます。
-
.NET クラスライブラリアセンブリ:や
mscorlib.dllなどの Mono クラスライブラリや、System.dllなどの .NET クラスライブラリファサードアセンブリが含まれます。netstandard.dll -
プラットフォームSDKアセンブリ:プラットプラットフォーム SDK 専用のマネージアセンブリが含まれます。例えば、ユニバーサル Windows プラットフォーム (UWP) SDK の一部であるアセンブリなどです。
windows.winmd -
Unity エンジンモジュールアセンブリ:など、Unity エンジンを構成するマネージアセンブリが含まれます。
UnityEngine.Core.dll -
プロジェクトアセンブリ:以下のようなプロジェクト固有のアセンブリが含まれます。
- などのスクリプトアセンブリ。
Assembly-CSharp.dll - プリコンパイルされたアセンブリ
- アセンブリ定義アセンブリ。
- パッケージアセンブリ。
通常、プロジェクトのアセンブリのうち、これらのカテゴリに当てはまらないものは Unity リンカーによって処理されず、 プレイヤービルド から除外されます。
ビルド中、Unity リンカーは適用可能なすべてのタイプのアセンブリを処理し、以下の処理を行います。
- アセンブリタイプと設定済みコードストリッピングレベルに適用されるルートマーキング規則に従って、ルートタイプ、メソッド、プロパティー、およびフィールドをマークします。
- 識別するためにマークしたルートを分析し、該当する依存関係マーキング規則に従って、これらのルートが依存するマネージコードをマークします。
- アプリケーションコードから実行パスで到達不能としてマークされていない残りのコードをアセンブリから削除します。
メソッド本体の編集
高ストリッピングレベルでは、Unity リンカーがメソッド本体を編集してコードサイズをさらに削減します。Unity リンカーは、.NET クラスライブラリのメソッド本体のみを編集します。
Unity リンカーは、以下の方法でメソッドボディを編集できます。
- 到達不能分岐の削除: ステートメントブロックをし、現在ターゲットプラットフォームに到達できない
ifをチェックします。System.Environment.OSVersion.Platform - フィールドのみにアクセスするインラインメソッド: フィールドを取得または設定するメソッドの呼び出しを、そのフィールドへの直接アクセスに置き換えます。これにより、多くの場合、メソッドを完全に取り除くことができます。Mono スクリプティングバック終了を使用する場合、Unity リンカーは、フィールドの可視性性に基づいて、メソッドの呼び出し元が直接フィールドにアクセスできる場合にのみこの変更を行います。IL2CPP では可視性規則は適用されないため、Unity リンカーが必要に応じて変更を行います。
- 値のみを返すインラインメソッド。
const - 空でreturn type.を持つメソッドの呼び出しを削除する
void - ブロックが空のときに、
try-finallyブロックを削除します。空の呼び出しを削除すると、空のfinallyブロックが作成される可能性があります。メソッド編集中にこれが発生すると、Unity リンカーはfinallyブロック全体を削除します。これが発生する 1 つのシナリオは、コンパイラーがtry-finallyを呼び出すためにDisposeループの一部としてforeachブロックを生成する場合です。try-finally