---
title: マネージコードストリッピングと Unity リンカー
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ja-jp/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/unity-linker
latest_url: https://docs.unity.com/ja-jp/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/unity-linker.md
generated_at: 2026-11-16T14:07:09.653Z
locale: ja-jp
---

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

> ストリッピング前に Unity リンカーがコードの要素を分析し、マークする方法を理解します。

Unity のビルドプロセスでは、Unity リンカーと呼ばれるツールを使用してマネージコードを削除します。Unity リンカーは、Unity で動作するようにカスタマイズされた [IL リンカー](https://github.com/mono/linker)のバージョンです。Unity エンジン専用の Unity リンカーのカスタムパーツは、一般に公開されていません。

Unity リンカーは、マネージコードストリッピングと、エンジンコードストリッピング (IL2CPP スクリプティングバック終了を通じて使用可能な別のプロセスで、未使用のエンジンコードを削除する) の一部の処理の両方を担当します。詳細については、「 [`PlayerSettings.StripEngineCode`](/engine/6000.0/script-reference/unityeditor/playersettings/stripenginecode.md) 」を参照してください。

## Unity リンカーによるアセンブリの削除方法##how-the-unity-linker-strips-assemblies

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` などのスクリプトアセンブリ。
  * プリコンパイルされたアセンブリ
  * [アセンブリ定義アセンブリ](https://docs.unity3d.com/Manual/assembly-definition-files.html)。
  * パッケージアセンブリ。

通常、プロジェクトのアセンブリのうち、これらのカテゴリに当てはまらないものは Unity リンカーによって処理されず、 プレイヤービルド から除外されます。

ビルド中、Unity リンカーは適用可能なすべてのタイプのアセンブリを処理し、以下の処理を行います。

1. アセンブリタイプと設定済みコードストリッピングレベルに適用される[ルートマーキング規則](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md#root-marking-rules)に従って、ルートタイプ、メソッド、プロパティー、およびフィールドをマークします。
2. 識別するためにマークしたルートを分析し、該当する[依存関係マーキング規則](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md#dependency-marking-rules)に従って、これらのルートが依存するマネージコードをマークします。
3. アプリケーションコードから実行パスで到達不能としてマークされていない残りのコードをアセンブリから削除します。

## メソッド本体の編集##editing-of-method-bodies

**高**[ストリッピングレベル](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)では、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`ブロックを生成する場合です。

> **Note:**
>
> メソッド本体の編集後、アセンブリのソースコードがアセンブリ内のコンパイル済みコードと一致しなくなり、デバッグがより難しくなる可能性があります。

## 追加リソース##additional-resources

* [注釈を使用したコード保持](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/preserving.md)
* [マーキング規則リファレンス](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md)
