ドキュメント

Unity Engine

Unity Engine

マネージコードストリッピングの設定

Unity エディターでマネージコードストリッピングを設定し、Unity が各ストリッピングレベルで行うことを理解します。
読み終わるまでの所要時間 6 分最終更新 6日前

マネージストリッピングレベルプロパティは、Unity リンカーがアプリケーションのコードを分析して除去するときに、どの規則に従うかを決定します。マネージストリッピングレベルを上げると、未使用のコードに対するリンカーの検索範囲が広がりますが、ビルド時間も長くなります。
マネージストリッピングレベルプロパティを変更するには、次の手順に従います。
  1. 編集>
    プロジェクト設定

    ?

    > プレイヤーに移動します。
  2. Other Settings (その他の設定) で、最適化の見出しに操作します。
  3. マネージストリッピングレベルプロパティを希望の値に設定します。

プロパティ

function

無効Unity はコードを削除しません。

この設定は Mono スクリプティングバックエンドでのみ使用でき、その場合はデフォルト設定です。
最小限Unity は、
UnityEngine
と .NET クラスライブラリのみを検索して、未使用のコードを探します。Unity はユーザー作成コードを削除しません。この設定は、予期しないランタイム動作を引き起こす可能性が最も低くなります。

この設定は、ビルドサイズよりも使い勝手を優先するプロジェクトに役立ちます。IL2CPP スクリプティングバックエンドを使用する場合は、これがデフォルト設定です。
Low (低)Unity は、すべての
UnityEngine
と .NET クラスライブラリで未使用のコードを検索します。ユーザーが記述したアセンブリも検索されますが、それらのタイプのいずれもプレイヤービルドに含まれるシーンで参照されていない場合のみ検索されます。この設定では、一部の未使用コードを削除する規則セットが適用されますが、リフレクションを使用するランタイムコードの動作の変更など、予期しない結果が発生する可能性を最小限に抑えます。

ノート:マネージストリッピングレベルが低い場合は、将来の廃止予定としてマークされるため、使用は推奨されません。代わりに Minimal または Medium を使用します。
Medium (中)Unity は、未使用のコードを見つけるためにすべてのアセンブリを部分的に検索します。この設定では、ビルドサイズを削減するために、より多くの種類のコードパターンを削除する一連のルールが適用されます。Unity は、使用されない可能性のあるコードをすべて削除するわけではありませんが、この設定によって、望ましくない動作変更や予期しない動作変更が発生するリスクが増加します。
High (高)Unity は、すべてのアセンブリの広範な検索を実行して、未使用のコードを見つけます。この設定では、Unityはコードの安定性よりもサイズ削減を優先し、可能な限り多くのコードを削除します。

この検索は、低いストリッピングレベルの場合よりもはるかに時間がかかる場合があります。この設定は、コンパクトなビルドサイズが非常に重要なプロジェクトにのみ使用します。アプリケーションを十分にテストし、
[Preserve]
属性と
link.xml
ファイルを慎重に使用して、Unity リンカーが重要なコードを削除しないことを確認します。

追加リソース