dotnet migrate

  • Článek

Tento článek se týká: ✔️ .NET Core 2.x SDK

Name

dotnet migrate – Migruje projekt .NET Core verze Preview 2 do projektu ve stylu sady .NET Core SDK.

Synopse

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

Description

Tento příkaz je zastaralý. Příkaz dotnet migrate už není dostupný od verze .NET Core 3.0 SDK. Může migrovat pouze projekt .NET Core verze Preview 2 do projektu 1.x .NET Core, který není podporován.

Ve výchozím nastavení příkaz migruje kořenový projekt a všechny odkazy, které kořenový projekt obsahuje. Toto chování je zakázané pomocí --skip-project-references možnosti za běhu.

Migraci je možné provést u následujících prostředků:

  • Jeden projekt zadáním souboru project.json , který se má migrovat.
  • Všechny adresáře zadané v souboru global.json předáním cesty k souboru global.json
  • Soubor solution.sln , do kterého migruje projekty odkazované v řešení.
  • Ve všech podadresářích daného adresáře rekurzivně.

Příkaz dotnet migrate uloží migrovaný soubor project.json v backup adresáři, který vytvoří, pokud adresář neexistuje. Toto chování je přepsáno pomocí --skip-backup možnosti .

Ve výchozím nastavení operace migrace vypíše stav procesu migrace do standardního výstupu (STDOUT). Pokud tuto možnost použijete --report-file <REPORT_FILE> , výstup se uloží do zadaného souboru.

Příkaz dotnet migrate podporuje pouze platné projekty ve verzi Preview 2 založené na souboru project.json. To znamená, že ho nemůžete použít k migraci projektů založených na DNX nebo Preview 1 project.json přímo do projektů MSBuild/csproj. Nejprve je potřeba ručně migrovat projekt na projekt založený na souboru project.json verze Preview 2 a pak ho pomocí dotnet migrate příkazu migrovat.

Argumenty

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Cesta k jedné z následujících možností:

  • soubor project.json , který se má migrovat.
  • soubor global.json : Složky zadané v souboru global.json se migrují.
  • soubor solution.sln : Projekty odkazované v řešení se migrují.
  • adresář, který se má migrovat: rekurzivně vyhledá soubory project.json , které se mají migrovat v zadaném adresáři.

Výchozí hodnota je aktuální adresář, pokud není zadáno nic.

Možnosti

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

Výstupní soubor sestavy migrace ve formátu JSON místo uživatelských zpráv.

-h|--help

Zobrazí krátkou nápovědu k příkazu.

-r|--report-file <REPORT_FILE>

Výstup sestavy migrace do souboru kromě konzoly.

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

Přeskočte migrování odkazů na projekt. Ve výchozím nastavení se odkazy na projekt migrují rekurzivně.

--skip-backup

Po úspěšné migraci přeskočte přesunutí project.json, global.json a *.xproj do backup adresáře.

-t|--template-file <TEMPLATE_FILE>

Soubor csproj šablony, který se má použít pro migraci. Ve výchozím nastavení se používá stejná šablona, jakou vyřadil dotnet new console .

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

Verze balíčku sady SDK, na kterou se odkazuje v migrované aplikaci. Výchozí je verze sady SDK v dotnet newnástroji .

-x|--xproj-file <FILE>

Cesta k souboru xproj, který se má použít. Vyžaduje se, pokud je v adresáři projektu více než jeden xproj.

Příklady

Migrace projektu v aktuálním adresáři a všech jeho závislostí mezi projekty:

dotnet migrate

Migrujte všechny projekty, které obsahují soubor global.json :

dotnet migrate path/to/global.json

Migrujte pouze aktuální projekt a žádné závislosti mezi projekty (P2P). Použijte také konkrétní verzi sady SDK:

dotnet migrate -s -v 1.0.0-preview4