次の方法で共有

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 オプションを使用して無効になります。

移行は、次の資産で実行できます。

  • 移行する project.json ファイルを指定して 1 つのプロジェクト。
  • global.json ファイルへのパスを渡すことによって、global.json ファイルで指定されたすべてのディレクトリ。
  • solution.sln(x) ファイル。ソリューションで参照されているプロジェクトが移行されます。
  • 指定されたディレクトリのすべてのサブディレクトリで再帰的に実行します。

dotnet migrate コマンドは、移行された project.json ファイルを backup ディレクトリ内に保持します。このファイルは、ディレクトリが存在しない場合に作成されます。 この動作は、--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(x) ファイル: ソリューションで参照されているプロジェクトが移行されます。
  • 移行するディレクトリ: 指定したディレクトリ内で移行する 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