dotnet migrate

  • Artykuł

Ten artykuł dotyczy: ✔️ .NET Core 2.x SDK

Nazwa

dotnet migrate — Migruje projekt platformy .NET Core w wersji zapoznawczej 2 do projektu w stylu zestawu SDK platformy .NET Core.

Streszczenie

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

Opis

To polecenie jest przestarzałe. Polecenie dotnet migrate nie jest już dostępne, począwszy od zestawu .NET Core 3.0 SDK. Można migrować tylko projekt .NET Core w wersji zapoznawczej 2 do projektu platformy .NET Core w wersji 1.x, który jest poza wsparciem.

Domyślnie polecenie migruje projekt główny i wszystkie odwołania do projektu, które zawiera projekt główny. To zachowanie jest wyłączone przy użyciu --skip-project-references opcji w czasie wykonywania.

Migrację można przeprowadzić na następujących zasobach:

  • Pojedynczy projekt przez określenie pliku project.json do migracji.
  • Wszystkie katalogi określone w pliku global.json , przekazując ścieżkę do pliku global.json .
  • Plik solution.sln , w którym migruje projekty, do których odwołuje się rozwiązanie.
  • Na wszystkich podkatalogach danego katalogu rekursywnie.

Polecenie dotnet migrate przechowuje zmigrowany plik project.json w backup katalogu, który tworzy, jeśli katalog nie istnieje. To zachowanie jest zastępowane przy użyciu --skip-backup opcji .

Domyślnie operacja migracji generuje stan procesu migracji do standardowych danych wyjściowych (STDOUT). Jeśli używasz --report-file <REPORT_FILE> opcji , dane wyjściowe zostaną zapisane w określonym pliku.

Polecenie dotnet migrate obsługuje tylko prawidłowe projekty oparte na formacie project.json w wersji zapoznawczej. Oznacza to, że nie można jej używać do migrowania projektów opartych na formacie DNX lub Preview 1 project.json bezpośrednio do projektów MSBuild/csproj. Najpierw należy ręcznie przeprowadzić migrację projektu do projektu opartego na formacie project.2 w wersji zapoznawczej 2, a następnie użyć dotnet migrate polecenia , aby przeprowadzić migrację projektu.

Argumenty

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Ścieżka do jednej z następujących:

  • plik project.json do migracji.
  • plik global.json : foldery określone w pliku global.json są migrowane.
  • plik solution.sln : projekty, do których odwołuje się rozwiązanie, są migrowane.
  • katalog do migracji: rekursywnie wyszukuje pliki project.json do migracji wewnątrz określonego katalogu.

Wartość domyślna bieżącego katalogu, jeśli nic nie zostanie określone.

Opcje

--format-report-file-json <REPORT_FILE>

Plik raportu migracji danych wyjściowych w formacie JSON, a nie komunikaty użytkowników.

-h|--help

Drukuje krótką pomoc dotyczącą polecenia.

-r|--report-file <REPORT_FILE>

Raport migracji danych wyjściowych do pliku oprócz konsoli programu .

-s|--skip-project-references [Debug|Release]

Pomiń migrowanie odwołań do projektu. Domyślnie odwołania do projektu są migrowane rekursywnie.

--skip-backup

Po pomyślnej migracji pomiń przenoszenie plików project.json, global.json i *.xproj do backup katalogu.

-t|--template-file <TEMPLATE_FILE>

Plik csproj szablonu do użycia na potrzeby migracji. Domyślnie używany jest ten sam szablon co ten, który został porzucony przez dotnet new console program .

-v|--sdk-package-version <VERSION>

Wersja pakietu zestawu SDK, do którego odwołuje się migrowana aplikacja. Wartość domyślna to wersja zestawu SDK w systemie dotnet new.

-x|--xproj-file <FILE>

Ścieżka do pliku xproj do użycia. Wymagane, jeśli w katalogu projektu znajduje się więcej niż jeden plik xproj.

Przykłady

Migrowanie projektu w bieżącym katalogu i wszystkich jego zależności między projektami:

dotnet migrate

Migrowanie wszystkich projektów, które zawiera plik global.json :

dotnet migrate path/to/global.json

Migrowanie tylko bieżącego projektu i brak zależności między projektami (P2P). Ponadto użyj określonej wersji zestawu SDK:

dotnet migrate -s -v 1.0.0-preview4