tooling

ツール

マイグレーション、スキャフォールディング、コンパイル済みモデル用の dotnet ef CLI および Visual Studio Package Manager Console コマンドです。

dotnet-ef CLI (src/dotnet-ef/)

RootCommand がグローバルオプションを解析します。サブコマンドは src/ef/Commands/ に実装されています。各サブコマンドは MSBuild を呼び出してビルドした後、OperationExecutor をホストする dotnet exec ef.dll をシェルから実行します。

PMC (src/EFCore.Tools/)

PowerShell モジュールです。Add-Migration、Update-Database、Scaffold-DbContext、Optimize-DbContext などを提供します。

MSBuild Tasks (src/EFCore.Tasks/)

NuGet パッケージ Microsoft.EntityFrameworkCore.Tasks は、ビルド時および発行時のコンパイル済みモデルとプリコンパイル済みクエリの生成を提供します。ターゲットは buildTransitive/Microsoft.EntityFrameworkCore.Tasks.targets にあります。

コマンドオプションの所有箇所

コマンドまたはオペレーションの契約を変更する前に、オプションを消費するコードを追跡してください。外側の dotnet-ef ランチャーはプロジェクトをビルドし、残りのコマンドライン引数を ef.dll に渡します。src/ef/Commands/ 内の内側のコマンドが、コマンド固有のオプションを解析します。

• 表示のみの動作は内側のコマンドに保持してください。たとえば、MigrationsAddCommand.Execute() から完了メッセージを抑制する場合は、その Reporter.WriteInformation() 呼び出しを条件で囲み、IOperationExecutor.AddMigration() は変更しないでください。
• 値を OperationExecutorBase 経由で渡すのは、Microsoft.EntityFrameworkCore.Design のデザイン時オペレーションで必要な場合に限ります。
• PMC と EFCore.Tasks は別々のエントリーポイントとして扱ってください。要求された動作がこれらのインターフェイスにも適用される場合にのみ変更してください。

テスト

• CLI テスト：test/dotnet-ef.Tests/、test/ef.Tests/
• EFCore.Tasks 専用のテストプロジェクトはありません。タスクやターゲットを変更する場合は、テストプロジェクトを作成し、EFOptimizeContext=true を指定して dotnet build／dotnet publish を手動で実行し、検証してください。

検証

• ツールを変更する場合は、テストプロジェクトを作成し、影響を受けるコマンドを手動で実行して動作を検証してください。
• dotnet ef migrations script の出力が想定される DDL と一致することを確認してください。