IL2CPP の概要
Unity スクリプトのコンパイルにおける IL2CPP の役割とその仕組みを理解します。
読み終わるまでの所要時間 11 分最終更新 6日前
IL2CPP (Intermediate Language To C++) は Unity のカスタム AOT (Ahead-of-Time) スクリプティングバックエンドで、もともとは iOS などの Mono と JIT (Just-in-Time) コンパイルをサポートしないプラットフォーム向けに開発されました。IL2CPP は、IL (中間言語) を C++ に変換し、プラットフォーム固有のネイティブコードにコンパイルします。次に、アプリケーションとともに、APK/AAB、iOS アプリバンドル、Windows 実行ファイルおよび DLL などのターゲットプラットフォームの標準形式でパッケージ化されます。
IL2CPP はすべてのプラットフォームでサポートされており、パフォーマンスの向上や起動時間の短縮など、Mono スクリプティングの終了よりもいくつかの利点があります。ただし、ビルドされたアプリケーションにマシンコードを含める必要があるため、通常はビルド時間と最終的にビルドされるアプリケーションのサイズの両方が増加します。
IL2CPP は、Mono と同じ方法でマネージコードのデバッグをサポートします。詳細は、「 Unity での C# コードのデバッグ 」を参照してください。
IL2CPP を使用したプロジェクトのビルド
IL2CPP を使用してプロジェクトをビルドするには、Unity インストールの一部として Il2CPP をインストールする必要があります。Unity のバージョンを最初にインストールするときに任意のモジュールとして IL2CPP を選択するか、Unity Hub を使用して既存のインストールに IL2CPP サポートを追加できます。詳細については、「 Unity Hub のインストール 」および「 Unity エディターへモジュールの追加 」を参照してください。
また、IL2CPP では、ターゲットプラットフォームにネイティブのシステムの一部が C++ コードを生成する必要があります。つまり、通常、クロスコンパイルはサポートされていないため、特定のターゲットプラットフォーム用に IL2CPP プレイヤーをビルドするには、同じプラットフォームで実行されているエディタからビルドする必要があります。例えば、IL2CPP で macOS プレイヤーをビルドするには、macOS でビルドする必要があります。Linux は例外で、他のデスクトッププラットフォームでの Linux プレイヤーの構築がサポートされています。詳細は、Linux IL2CPP クロスコンパイラー を参照してください。
Unity がアプリケーションのビルドに使用するスクリプティングバック終了は、以下の 2 つの方法のいずれかで変更できます。
-
エディターのメニューから。プレイヤー設定メニューからスクリプトバックエンドを変更するには、以下の手順を実行します。プレイヤー設定
?
- 編集> に移動します。プロジェクト設定
?
- プレイヤー設定ボタンをクリックして、Inspector で現在のプラットフォームのプレイヤー設定を開きます。
- Other Settings サブメニューの下の 設定セクションの見出しに操作します。
- ドロップダウン メニューをクリックし、スクリプティングバックエンド:
?
を選択します。IL2CPP?
ビルドプロファイルウィンドウからプレイヤー設定メニューを開くこともできます。ファイル>ビルドプロファイルに移動し、プレイヤー設定タブをクリックします。 - 編集>
-
エディタースクリプティング API を使用。プロパティを使用して、Unity が使用するスクリプティング バックエンドの終了を変更します。
PlayerSettings.SetScriptingBackend

The Configuration section of the Player settings
個々のプラットフォームの IL2CPP 要件を含む、デスクトップ プラットフォームのシステム要件の詳細は、『 Unity のシステム要件 』の「 デスクトップ 」セクションを参照してください。
IL2CPP の仕組み
IL2CPP でビルドする場合、Unity は以下の手順を自動的に実行します。
- Roslyn C# コンパイラーは、アプリケーションの C# コードと必要なパッケージコードを .NET DLL (マネージセンブリ) にコンパイルします。
- Unity はマネージコードストリッピングを適用します。このステップでは、構築したアプリケーションのサイズを大幅に削減できます。
- IL2CPP バック終了は、すべてのマネージセンブリを標準の C++ コードに変換します。
- C++ コンパイラーは、生成された C++ コードと IL2CPP のランタイム部分をネイティブプラットフォームコンパイラーでコンパイルします。
- Unity は、ターゲットのプラットフォームに応じて実行ファイルまたは DLL を作成します。
IL2CPP ビルド時間の最適化
IL2CPP を使用したプロジェクトのビルド時間は、Mono を使用した場合よりも大幅に長くなることがあります。ただし、ビルド時間を短縮するためにいくつかのことができます。
- プロジェクトをビルドする前に、マルウェア対策ソフトウェアのスキャンから Unity プロジェクトとターゲットビルドフォルダーを除外します。
- プロジェクトとターゲットビルドフォルダーは、使用可能な最速のディスクドライブに保存します。IL コードを C++ に変換してコンパイルするには、多数の読み取り/書き込み操作が必要になるため、ストレージデバイスが高速になると、このプロセスが高速化されます。
- プレイヤー設定で IL2CPP コード生成オプションを変更します。IL2CPP のコード生成方法を変更するには、プレイヤー設定を開き、IL2CPP コード生成オプションを設定します。デフォルトでは、「ランタイムスピードの最適化」オプションが有効になっており、ランタイムでの IL2CPP の影響を軽減するマシンコードが生成されます。ビルド時間を短縮するには、このオプションを設定してコードサイズとビルド時間を最適化します。このメソッドは、バイナリ実行ファイルで生成されるマシンコードの数が少ないため、ランタイムのパフォーマンスが低下しますが、ビルド時間とバイナリサイズが大幅に削減されます。
Burstによるランタイムパフォーマンスの最適化
適切なプロジェクトでは、Burst コンパイラーを IL2CPP とともに使用して、コードの互換性のある部分を高度に最適化されたマシンコードにコンパイルすることで、プロジェクトのランタイムパフォーマンスを向上させることができます。詳細は、Burst コンパイル を参照してください。
追加リソース
- 📚 ドキュメント: IL2CPP コンパイラーオプションリファレンス
- 📚 ドキュメント: Linux IL2CPP クロスコンパイラー
- 📚 ドキュメント: ビルドのファイルサイズの削減
- 👥 コミュニティ: IL2CPP 内部の概要。