dotnet migrálása

  • Cikk

Ez a cikk a következőre vonatkozik: ✔️ .NET Core 2.x SDK

Name

dotnet migrate – 2. előzetes verziójú .NET Core-projektet migrál egy .NET Core SDK-stílusú projektbe.

Áttekintés

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

Ez a parancs elavult. A dotnet migrate parancs már nem érhető el a .NET Core 3.0 SDK-val kezdve. Csak egy előzetes verziójú .NET Core-projektet migrálhat egy 1.x .NET Core-projektbe, amely nem támogatott.

Alapértelmezés szerint a parancs migrálja a gyökérprojektet és a gyökérprojektben található összes projekthivatkozást. Ez a viselkedés futásidőben le van tiltva a --skip-project-references beállítással.

A migrálás a következő objektumokon végezhető el:

  • Egyetlen projekt a migrálni kívánt project.json fájl megadásával.
  • A global.json fájlban megadott összes könyvtár a global.json fájl elérési útjának megadásával.
  • Egy solution.sln fájl, amely a megoldásban hivatkozott projekteket migrálja.
  • Az adott könyvtár összes alkönyvtárában rekurzív módon.

A dotnet migrate parancs egy könyvtárban backup tartja a migrált project.json fájlt, amelyet akkor hoz létre, ha a könyvtár nem létezik. Ezt a viselkedést felülbírálta a --skip-backup beállítással.

Alapértelmezés szerint a migrálási művelet a migrálási folyamat állapotát standard kimenetre (STDOUT) adja vissza. Ha ezt a --report-file <REPORT_FILE> beállítást használja, a kimenet a megadott fájlba lesz mentve.

A dotnet migrate parancs csak az érvényes 2. előzetes verziójú project.json-alapú projekteket támogatja. Ez azt jelenti, hogy nem használhatja DNX- vagy Preview 1 project.json-alapú projektek közvetlenül MSBuild/csproj projektekbe való migrálásához. Először manuálisan kell migrálnia a projektet egy Preview 2 project.json-alapú projektbe, majd az dotnet migrate paranccsal át kell telepítenie a projektet.

Argumentumok

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Az alábbi lehetőségek egyikének elérési útja:

  • egy áttelepítendő project.json fájl.
  • global.json fájl: a global.json fájlban megadott mappák áttelepítése folyamatban van.
  • solution.sln fájl: a megoldásban hivatkozott projektek migrálva lesznek.
  • egy áttelepítendő könyvtár: rekurzív módon megkeresi a project.json fájlokat, és áttelepíti a megadott könyvtáron belül.

Alapértelmezés szerint az aktuális könyvtár, ha nincs megadva semmi.

Beállítások

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

Kimeneti migrálási jelentésfájl JSON-fájlként a felhasználói üzenetek helyett.

-h|--help

Kinyomtat egy rövid súgót a parancshoz.

-r|--report-file <REPORT_FILE>

Kimeneti migrálási jelentés egy fájlba a konzolon kívül.

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

Hagyja ki a projekthivatkozások migrálását. Alapértelmezés szerint a projekthivatkozások rekurzív módon lesznek migrálva.

--skip-backup

A sikeres migrálás után hagyja ki a project.json, global.json és *.xproj könyvtárba való backup áthelyezését.

-t|--template-file <TEMPLATE_FILE>

A migráláshoz használandó csproj-fájl sablonja. Alapértelmezés szerint ugyanazt a sablont használja a rendszer, mint amelyik eldobott.dotnet new console

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

Az sdk-csomagnak az áttelepített alkalmazásban hivatkozott verziója. Az alapértelmezett érték az SDK verziója a fájlban dotnet new.

-x|--xproj-file <FILE>

A használni kívánt xproj-fájl elérési útja. Akkor szükséges, ha egy projektkönyvtárban több xproj található.

Példák

Migráljon egy projektet az aktuális könyvtárban, és az összes projekt-projekt függőségét:

dotnet migrate

Migrálja az összes olyan projektet, amelyet a global.json fájl tartalmaz:

dotnet migrate path/to/global.json

Csak az aktuális projektet migrálja, és nincs projekt–projekt (P2P) függőség. Emellett használjon egy adott SDK-verziót is:

dotnet migrate -s -v 1.0.0-preview4