Freigeben über

dotnet migrate

  • Artikel

Dieser Artikel gilt für: ✔️ .NET Core 2.x SDK

Name

dotnet migrate – Migriert ein Preview 2 .NET Core-Projekt zu einem .NET Core SDK-Formatprojekt.

Zusammenfassung

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

Beschreibung

Dieser Befehl ist veraltet. Der Befehl "dotnet migrate" ist ab .NET Core 3.0 SDK nicht mehr verfügbar. Es kann nur ein Preview 2 .NET Core-Projekt zu einem 1.x .NET Core-Projekt migrieren, das nicht unterstützt wird.

Standardmäßig migriert der Befehl das Stammprojekt und alle Projektverweise, die das Stammprojekt enthält. Dieses Verhalten wird mit der Option --skip-project-references zur Laufzeit deaktiviert.

Die Migration kann für die folgenden Ressourcen ausgeführt werden:

  • Ein einzelnes Projekt durch Angeben der zu migrierenden project.json Datei.
  • Alle in der global.json Datei angegebenen Verzeichnisse, indem Sie einen Pfad zur global.json Datei übergeben.
  • Eine solution.sln(x) Datei, in der die Projekte migriert werden, auf die in der Lösung verwiesen wird.
  • In allen Unterverzeichnissen des angegebenen Verzeichnisses rekursiv.

Der Befehl dotnet migrate behält die migrierte project.json Datei in einem backup Verzeichnis bei, das erstellt wird, wenn das Verzeichnis nicht vorhanden ist. Dieses Verhalten wird mithilfe der Option --skip-backup außer Kraft gesetzt.

Standardmäßig gibt der Migrationsvorgang den Status des Migrationsprozesses in die Standardausgabe (STDOUT) aus. Wenn Sie die Option --report-file <REPORT_FILE> verwenden, wird die Ausgabe in der angegebenen Datei gespeichert.

Der Befehl dotnet migrate unterstützt nur gültige Preview 2-project.json-basierte Projekte. Dies bedeutet, dass Sie es nicht verwenden können, um DNX- oder Preview 1-project.json-basierte Projekte direkt zu MSBuild/csproj-Projekten zu migrieren. Sie müssen das Projekt zuerst manuell zu einem vorschau 2 project.json-basierten Projekt migrieren und dann den Befehl dotnet migrate verwenden, um das Projekt zu migrieren.

Argumente

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Der Pfad zu einem der folgenden Optionen:

  • eine project.json Datei, die migriert werden soll.
  • eine global.json Datei: Die in global.json angegebenen Ordner werden migriert.
  • eine solution.sln(x) Datei: Die projekte, auf die in der Projektmappe verwiesen wird, werden migriert.
  • ein zu migrierender Verzeichnis: rekursiv sucht nach project.json Dateien, die innerhalb des angegebenen Verzeichnisses migriert werden sollen.

Standardmäßig wird das aktuelle Verzeichnis verwendet, wenn nichts angegeben wird.

Optionen

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

Ausgabemigrationsberichtsdatei als JSON anstelle von Benutzernachrichten.

-h|--help

Druckt eine kurze Hilfe für den Befehl.

-r|--report-file <REPORT_FILE>

Ausgabemigrationsbericht zu einer Datei zusätzlich zur Konsole.

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

Das Migrieren von Projektverweise wird übersprungen. Standardmäßig werden Projektverweise rekursiv migriert.

--skip-backup

Überspringen Sie das Verschieben project.json, global.jsonund *.xproj nach erfolgreicher Migration in ein backup Verzeichnis.

-t|--template-file <TEMPLATE_FILE>

Csproj-Vorlagendatei, die für die Migration verwendet werden soll. Standardmäßig wird dieselbe Vorlage wie die von dotnet new console abgelegte Vorlage verwendet.

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

Die Version des SDK-Pakets, auf das in der migrierten App verwiesen wird. Der Standardwert ist die Version des SDK in dotnet new.

-x|--xproj-file <FILE>

Der Pfad zur zu verwendenden xproj-Datei. Erforderlich, wenn mehrere xproj in einem Projektverzeichnis vorhanden sind.

Beispiele

Migrieren Sie ein Projekt im aktuellen Verzeichnis und alle zugehörigen Projekt-zu-Projekt-Abhängigkeiten:

dotnet migrate

Migrieren Sie alle Projekte, die global.json Datei umfassen:

dotnet migrate path/to/global.json

Migrieren Sie nur das aktuelle Projekt und keine Projekt-zu-Projekt-Abhängigkeiten (P2P). Verwenden Sie außerdem eine bestimmte SDK-Version:

dotnet migrate -s -v 1.0.0-preview4