dotnet migrate
この記事の対象: ✔️ .NET Core 2.x SDK
dotnet migrate
- Preview 2 .NET Core プロジェクトを .NET Core SDK スタイルのプロジェクトに移行します。
dotnet migrate [<SOLUTION_FILE|PROJECT_DIR>] [--format-report-file-json <REPORT_FILE>]
[-r|--report-file <REPORT_FILE>] [-s|--skip-project-references [Debug|Release]]
[--skip-backup] [-t|--template-file <TEMPLATE_FILE>] [-v|--sdk-package-version]
[-x|--xproj-file]
dotnet migrate -h|--help
このコマンドは非推奨です。 dotnet migrate
コマンドは、.NET Core 3.0 SDK 以降では使用できなくなりました。 これは、Preview 2 .NET Core プロジェクトを 1.x .NET Core プロジェクト (サポート対象外) にしか移行できません。
既定では、このコマンドは、ルート プロジェクトとルート プロジェクトに含まれるすべてのプロジェクト参照を移行します。 この動作は、実行時に --skip-project-references
オプションを使って、無効にすることができます。
移行は次のアセットで実行できます。
- 1 つのプロジェクト。移行する project.json ファイルを指定します。
- global.json ファイルで指定されているすべてのディレクトリ。global.json ファイルへのパスを渡します。
- solution.sln ファイル。ソリューションで参照されているプロジェクトを移行します。
- 特定のディレクトリのすべてのサブディレクトリ (再帰的)。
dotnet migrate
コマンドは、backup
ディレクトリ内に移行された project.json ファイルを保持します。ディレクトリが存在しない場合は作成されます。 この動作は、--skip-backup
オプションを使ってオーバーライドされます。
既定では、移行操作は、標準出力 (STDOUT) に移行プロセスの状態を出力します。 --report-file <REPORT_FILE>
オプションを使うと、指定したファイルに出力が保存を指定します。
dotnet migrate
コマンドは、有効な Preview 2 project.json ベースのプロジェクトのみをサポートします。 つまり、DNX または Preview 1 の project.json ベースのプロジェクトを MSBuild/csproj プロジェクトに直接移行するためには使えません。 最初にプロジェクトを Preview 2 project.json ベースのプロジェクトに手動で移行し、その後で dotnet migrate
コマンドを使ってプロジェクトを移行する必要があります。
PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR
次のいずれかへのパスです。
- 移行する project.json ファイル。
- global.json ファイル: global.json で指定されているフォルダーを移行します。
- solution.sln ファイル: ソリューションで参照されているプロジェクトを移行します。
- 移行するディレクトリ: 移行する project.json ファイルを再帰的に検索して、指定したディレクトリ内に移行します。
何も指定しない場合の既定値は現在のディレクトリです。
--format-report-file-json <REPORT_FILE>
ユーザー メッセージではなく、JSON として移行レポート ファイルを出力します。
-h|--help
コマンドの短いヘルプを印刷します。
-r|--report-file <REPORT_FILE>
移行レポートをコンソールだけでなく、ファイルに出力します。
-s|--skip-project-references [Debug|Release]
プロジェクト参照の移行をスキップします。 既定では、プロジェクト参照は再帰的に移行されます。
--skip-backup
移行が成功した後、project.json、global.json、および *.xproj の backup
ディレクトリへの移動をスキップします。
-t|--template-file <TEMPLATE_FILE>
移行に使用するテンプレートの csproj ファイル。 既定では、dotnet new console
によってドロップされるテンプレートと同じテンプレートが使用されます。
-v|--sdk-package-version <VERSION>
移行されたアプリで参照される sdk パッケージのバージョンです。 既定値は、dotnet new
内の SDK のバージョンです。
-x|--xproj-file <FILE>
使用する xproj ファイルへのパス。 プロジェクト ディレクトリに複数の xproj がある場合に必要です。
現在のディレクトリのプロジェクトとそのプロジェクト間の依存関係をすべて移行します。
dotnet migrate
global.json ファイルに含まれるすべてのプロジェクトを移行します。
dotnet migrate path/to/global.json
現在のプロジェクトのみを移行し、プロジェクト間 (P2P) の依存関係は移行しません。 また、特定の SDK バージョンを使います。
dotnet migrate -s -v 1.0.0-preview4
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。