dotnet migratedotnet migrate

Dieses Thema gilt für: ✓ .NET Core SDK 1.x .NET Core SDK 2.xThis topic applies to: ✓ .NET Core SDK 1.x .NET Core SDK 2.x

NameName

dotnet migrate: Migriert ein .NET Core-Projekt von Preview 2 in ein .NET Core-Projekt von SDK 1.0.dotnet migrate - Migrates a Preview 2 .NET Core project to a .NET Core SDK 1.0 project.

ÜbersichtSynopsis

dotnet migrate [<SOLUTION_FILE|PROJECT_DIR>] [-t|--template-file] [-v|--sdk-package-version] [-x|--xproj-file] [-s|--skip-project-references] [-r|--report-file] [--format-report-file-json] [--skip-backup] [-h|--help]

BeschreibungDescription

Der dotnet migrate-Befehl migriert ein gültiges project.json-basiertes Projekt von Preview 2 in ein gültiges csproj-Projekt von .NET Core SDK 1.0.The dotnet migrate command migrates a valid Preview 2 project.json-based project to a valid .NET Core SDK 1.0 csproj project.

Standardmäßig migriert der Befehl das Stammprojekt und alle Projektverweise, die das Stammprojekt enthält.By default, the command migrates the root project and any project references that the root project contains. Dieses Verhalten ist mithilfe der --skip-project-references-Option zur Laufzeit deaktiviert.This behavior is disabled using the --skip-project-references option at runtime.

Migration wird auf Folgendes ausgeführt:Migration is performed on the following:

  • Ein einzelnes Projekt durch Angabe der zu migrierenden project.json-Datei.A single project by specifying the project.json file to migrate.
  • Alle Verzeichnisse, die in der global.json-Datei angegeben sind, indem ein Pfad zur global.json-Datei übergeben wird.All of the directories specified in the global.json file by passing in a path to the global.json file.
  • Ein solution.sln-Datei, in dem die Projekte, auf die in der Projektmappe verwiesen wird, migriert werden.A solution.sln file, where it migrates the projects referenced in the solution.
  • Rekursiv für alle Unterverzeichnisse im angegebenen Verzeichnis.On all sub-directories of the given directory recursively.

Der dotnet migrate-Befehl speichert die migrierte project.json-Datei in einem backup-Verzeichnis, das erstellt wird, falls das Verzeichnis noch nicht vorhanden ist.The dotnet migrate command keeps the migrated project.json file inside a backup directory, which it creates if the directory doesn't exist. Dieses Verhalten wird überschrieben, mit der --skip-backup Option.This behavior is overridden using the --skip-backup option.

Standardmäßig gibt der Migrationsvorgang den Status der Migration in die Standardausgabe (STDOUT) aus.By default, the migration operation outputs the state of the migration process to standard output (STDOUT). Bei Verwendung der --report-file <REPORT_FILE>-Option wird die Ausgabe in die angegebene Datei gespeichert.If you use the --report-file <REPORT_FILE> option, the output is saved to the file specify.

Der dotnet migrate-Befehl unterstützt nur gültige project.json-basiere Projekte von Preview 2.The dotnet migrate command only supports valid Preview 2 project.json-based projects. Dies bedeutet, dass Sie ihn nicht zum Migrieren von project.json-basierten Projekte von DNX oder Preview 1 direkt an MSBuild/csproj-Projekte verwenden können.This means that you cannot use it to migrate DNX or Preview 1 project.json-based projects directly to MSBuild/csproj projects. Sie müssen zuerst das Projekt manuell auf ein project.json-basiertes Projekt von Preview 2 migrieren und anschließend den dotnet migrate-Befehl verwenden, um das Projekt zu migrieren.You first need to manually migrate the project to a Preview 2 project.json-based project and then use the dotnet migrate command to migrate the project.

ArgumenteArguments

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Der Pfad zu einem der Folgenden:The path to one of the following:

  • eine project.json-Datei zum Migrieren.a project.json file to migrate.
  • eine global.json-Datei wird die in global.json angegebenen Ordner migrieren.a global.json file, it will migrate the folders specified in global.json.
  • eine solution.sln-Datei wird die Projekte migrieren, auf die in der Projektmappe verwiesen wird.a solution.sln file, it will migrate the projects referenced in the solution.
  • ein Verzeichnis zum Migrieren, das rekursiv nach project.json-Dateien suchen wird, um sie zu migrieren.a directory to migrate, it will recursively search for project.json files to migrate.

Wenn nichts angegeben ist, wird standardmäßig das aktuelle Verzeichnis gewählt.Defaults to current directory if nothing is specified.

OptionenOptions

-h|--help

Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command.

-t|--template-file <TEMPLATE_FILE>

Für die Migration zu verwendende CSPROJ-Vorlagendatei.Template csproj file to use for migration. Standardmäßig wird die gleiche Vorlage verwendet, die von dotnet new console abgelegt wurde.By default, the same template as the one dropped by dotnet new console is used.

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

Die Version des SDK-Pakets, auf das in der migrierten App verwiesen wird.The version of the sdk package that's referenced in the migrated app. Der Standardwert ist die Version des SDK in dotnet new.The default is the version of the SDK in dotnet new.

-x|--xproj-file <FILE>

Der Pfad zur XPROJ-Datei, die verwendet werden soll.The path to the xproj file to use. Erforderlich, wenn mehrere XPROJ-Dateien in einem Projektverzeichnis vorhanden sind.Required when there is more than one xproj in a project directory.

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

Die Migration von Projektverweisen wird übersprungen.Skip migrating project references. Standardmäßig werden Projektverweise rekursiv migriert.By default, project references are migrated recursively.

-r|--report-file <REPORT_FILE>

Der Migrationsbericht wird in eine Datei und in der Konsole ausgegeben.Output migration report to a file in addition to the console.

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

Die Migrationsberichtsdatei wird als JSON statt als Benutzermeldungen ausgegeben.Output migration report file as JSON rather than user messages.

--skip-backup

Das Verschieben der Dateien project.json, global.json und *.xproj in ein backup-Verzeichnis nach der erfolgreichen Migration wird übersprungen.Skip moving project.json, global.json, and *.xproj to a backup directory after successful migration.

BeispieleExamples

Migrieren Sie ein Projekt und alle Abhängigkeiten des Projekts mit anderen Projekten in das aktuelle Verzeichnis:Migrate a project in the current directory and all of its project-to-project dependencies:

dotnet migrate

Migrieren Sie alle Projekte, die die global.json-Datei umfasst:Migrate all projects that global.json file includes:

dotnet migrate path/to/global.json

Migrieren Sie nur das aktuelle Projekt und keine Abhängigkeiten des Projekts mit anderen Projekten (P2P).Migrate only the current project and no project-to-project (P2P) dependencies. Verwenden Sie außerdem eine bestimmte SDK-Version:Also, use a specific SDK version:

dotnet migrate -s -v 1.0.0-preview4