
# 最適化

ジェネレーターは、Spring が実行時にリフレクションで行うこと (Bean を見つける、生成する、そのプロパティを読む、AOP のためにプロキシ化する) を置き換えます。そのすべてを、ビルド時に素の Dart コードとして書き出します。このセクションでは、そのコードを小さく、ビルドを速く保つための選択を説明します。

## 使う理由

生成コードはアプリが同梱するコードです。素朴なジェネレーターなら、すべてのクラスを完全に記述し、すべての Bean にプロキシクラスを書き、すべてのスターターのモジュールをすべてのアプリに入れるでしょう。それでも動きますが、アプリは決して実行されない大量のコードを抱えることになり、Flutter と Web ではそれがダウンロードの増大と起動の遅延を意味します。

ビルドはアプリケーション全体を見ています。その Bean、アスペクト、呼び出し、設定です。そのため、アプリケーションが使わないことが確かなものを省き、ビルドが見なかったものが実行時に現れたときには、それを明確に伝えることができます。

## 概要

| 最適化 | 節約するもの | ページ |
|---|---|---|
| リフレクションなし | `dart:mirrors` は使われません。すべてが素のコンストラクター呼び出しとクロージャーで、AOT、Flutter、Web で動き、ミニファイに耐えます | [生成の仕組み](../how-it-works.md) |
| コンパイラーがツリーシェイキングできるコード | 生成される参照は直接的 (`create: (r) => Greeter(r.dependency<Clock>(name: r'clock'))`) で、記述はトップレベル関数を使う定数で、条件付きのコードはコンパイル時定数の背後にあるので、Dart のコンパイラーは何も到達しないものを取り除きます | このページ、下記 |
| 実行されるものだけ: イントロスペクション | クラスは、アプリケーションがそれに対して行うことについてだけ記述されます: ゲッター、コンストラクターとセッター、またはメソッド | [実行されるものだけ: イントロスペクション](introspection.md) |
| AOP プロキシの刈り込み | どのアドバイスも一致しえない Bean にはプロキシクラスがなく、残るプロキシにはアドバイスされるメンバーだけがあります | [AOP プロキシ](aop-proxies.md) |
| 遅延されるプロキシ | スターターは自身の Bean のプロキシクラスを書かず、アプリケーションはそのアスペクトが必要とするものだけを書きます | [AOP プロキシ](aop-proxies.md#遅延されるプロキシ-スターターはアプリケーションに任せる) |
| ビルドから外されるモジュール | アプリケーションのプロパティが、スターターのモジュール (デバッグパネル) をアプリから、またはリリースからだけ外します | [ビルドから外されるモジュール](build-conditions.md) |
| スターターのパート | ジェネレーターはコアとスターターごとのパートでできていて、パートはアプリケーションがそのスターターに届くときだけ動きます。パートはモジュールのようにビルドのキーに従えます | [生成の仕組み](../how-it-works.md#スターターのパート)、[キーで決まるジェネレーターのパート](build-conditions.md#キーで決まるジェネレーターのパート) |
| ビルド速度 | ファイルは解決される前にテキストでチェックされ、必要な本体だけが解決され、追加の作業は何かを取り除ける場合にだけ行われます | [ビルド速度](build-speed.md) |

## コンパイラーが取り除けるコード

リリースビルド向けの Dart のコンパイラー (dart2js、AOT) は、何も参照しないコードを取り除きます。ツリーシェイキングです。リフレクションはそれを妨げます。どのクラスも名前で検索される可能性があるからです。生成コードはそれを助けます。

- **直接の参照。** Bean はそのコンストラクターを呼ぶクロージャーで生成されます。名前でクラスを検索するものはないので、どの Bean も呼び出しも使わないクラスは取り除かれます。
- **定数の記述。** 型パラメーターのないクラスのイントロスペクションは `const Introspection` で、そのクロージャーはトップレベル関数 (`_$get3`、`_$create5`) です。ビルドが省いた部分には関数がまったくありません。
- **定数の条件。** デバッグとプロファイルのビルド専用のモジュールは `if (!const bool.fromEnvironment('dart.vm.product'))` の下に列挙されます。リリースビルドではその条件は定数 `false` なので、その要素、モジュール、それだけが到達するすべてが取り除かれます。[ビルドから外されるモジュール](build-conditions.md#リリースでコンパイラーが取り除くものとその理由) を参照してください。
- **共有される定数。** 刈り込まれたプロキシは、モジュールごとに一つの既知のアドバイザーの定数セットを共有し、`AopProxyFactory.pruned()` の理由のテキストは、すべての生成ファイルではなくランタイムに一度だけ書かれます。

## 変わらないもの

どの最適化もアプリケーションの振る舞いを保ちます。

- 一致するアドバイスのない Bean は、AOP のオプションにかかわらず、実行時にラップされることはありません。
- 記述の一部が欠けていると、それを必要とするコードは、クラス、部分、修正方法 (`add @Introspected() to Book`) を示すメッセージで失敗し、空のオブジェクトになることはありません。
- ビルドが見なかったアドバイス (コードで登録されたもの) は、黙ってスキップされるのではなく、メッセージとともに起動を失敗させます。
- ビルドから外されたモジュールは、スターターがそれを持っていなかったのとまったく同じです。

各最適化は緩めることができます。`@Introspected()` はクラスを完全に記述し、`aop_prune: false` はすべてのプロキシを残し、`true` に設定したビルドプロパティはモジュールをすべてのビルドに残します。[オプション](../options.md) を参照してください。

## 関連項目

- [生成の仕組み](../how-it-works.md)
- [オプション](../options.md)
- [実行されるものだけ: イントロスペクション](introspection.md)
- [AOP プロキシ: 刈り込みと遅延](aop-proxies.md)
- [ビルドから外されるモジュール](build-conditions.md)
- [スターターのパート](../how-it-works.md#スターターのパート)
- [ビルド速度](build-speed.md)
