dotnet migratedotnet migrate

Este tema se aplica a: ✓ SDK de .NET Core 1.x y versiones posterioresThis topic applies to: ✓ .NET Core 1.x SDK and later versions

nombreName

dotnet migrate: migra un proyecto .NET Core de la versión preliminar 2 a un proyecto del estilo de SDK de .NET Core.dotnet migrate - Migrates a Preview 2 .NET Core project to a .NET Core SDK-style project.

Nota

dotnet migrate se quitará del SDK de .NET Core 3.0 en la próxima publicación de versión preliminar.dotnet migrate will be removed from the .NET Core 3.0 SDK in the next preview release.

SinopsisSynopsis

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

DESCRIPCIÓNDescription

Con el comando dotnet migrate se migra un proyecto válido basado en project.json de la versión preliminar 2 a un proyecto válido csproj del estilo de SDK de .NET Core.The dotnet migrate command migrates a valid Preview 2 project.json-based project to a valid .NET Core SDK-style csproj project.

De forma predeterminada, el comando migra el proyecto raíz y todas las referencias de proyecto que contiene.By default, the command migrates the root project and any project references that the root project contains. Este comportamiento se deshabilita mediante la opción --skip-project-references en tiempo de ejecución.This behavior is disabled using the --skip-project-references option at runtime.

La migración se puede realizar en los recursos siguientes:Migration can be performed on the following assets:

  • Un único proyecto mediante la especificación del archivo project.json que quiere migrar.A single project by specifying the project.json file to migrate.
  • Todos los directorios especificados en el archivo global.json pasando una ruta al archivo global.json.All of the directories specified in the global.json file by passing in a path to the global.json file.
  • Un archivo solution.sln, donde se migran los proyectos a los que se hace referencia en la solución.A solution.sln file, where it migrates the projects referenced in the solution.
  • Todos los subdirectorios del directorio dado de manera recursiva.On all subdirectories of the given directory recursively.

El comando dotnet migrate mantiene el archivo project.json migrado dentro de un directorio backup, que se crea en caso de que no exista.The dotnet migrate command keeps the migrated project.json file inside a backup directory, which it creates if the directory doesn't exist. Este comportamiento se invalida con la opción --skip-backup.This behavior is overridden using the --skip-backup option.

De forma predeterminada, la operación de migración genera el estado del proceso de migración a la salida estándar (STDOUT).By default, the migration operation outputs the state of the migration process to standard output (STDOUT). Si usa la opción --report-file <REPORT_FILE>, la salida se guarda en el archivo especificado.If you use the --report-file <REPORT_FILE> option, the output is saved to the file specify.

El comando dotnet migrate solo admite proyectos válidos basados en project.json de la versión preliminar 2.The dotnet migrate command only supports valid Preview 2 project.json-based projects. Esto significa que no se puede usar para migrar DNX o los proyectos basados en project.json de la versión preliminar 1 directamente a proyectos de MSBuild/csproj.This means that you cannot use it to migrate DNX or Preview 1 project.json-based projects directly to MSBuild/csproj projects. Primero debe migrar manualmente el proyecto a un proyecto basado en project.json de la versión preliminar 2 y luego usar el comando dotnet migrate para migrar el proyecto.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.

ArgumentosArguments

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

La ruta de acceso a uno de los siguientes elementos:The path to one of the following:

  • Un archivo project.json para migrar.a project.json file to migrate.
  • Un archivo global.json: se migran las carpetas especificadas en global.json.a global.json file: the folders specified in global.json are migrated.
  • Un archivo solution.sln: se migran los proyectos a los que se hace referencia en la solución.a solution.sln file: the projects referenced in the solution are migrated.
  • Un directorio para migrar: se buscan de forma recursiva los archivos project.json que se van a migrar dentro del directorio especificado.a directory to migrate: recursively searches for project.json files to migrate inside the specified directory.

Si no se especifica nada, se toma como valor predeterminado el directorio actual.Defaults to current directory if nothing is specified.

OpcionesOptions

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

Salida del archivo de informe de migración como JSON en lugar de mensajes de usuario.Output migration report file as JSON rather than user messages.

-h|--help

Imprime una corta ayuda para el comando.Prints out a short help for the command.

-r|--report-file <REPORT_FILE>

Salida del informe de migración a un archivo además de a la consola.Output migration report to a file in addition to the console.

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

Omite la migración de referencias de proyecto.Skip migrating project references. De forma predeterminada, las referencias de proyecto se migran de forma recursiva.By default, project references are migrated recursively.

--skip-backup

Omite el traslado de project.json, global.json y *.xproj a un directorio backup tras la realización correcta de la migración.Skip moving project.json, global.json, and *.xproj to a backup directory after successful migration.

-t|--template-file <TEMPLATE_FILE>

Archivo csproj de plantilla que se utilizará para la migración.Template csproj file to use for migration. De forma predeterminada, se usa la misma plantilla que la descartada por dotnet new console.By default, the same template as the one dropped by dotnet new console is used.

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

La versión del paquete sdk a la que se hace referencia en la aplicación migrada.The version of the sdk package that's referenced in the migrated app. El valor predeterminado es la versión del SDK en dotnet new.The default is the version of the SDK in dotnet new.

-x|--xproj-file <FILE>

La ruta de acceso al archivo xproj que se usará.The path to the xproj file to use. Necesario cuando hay más de un archivo xproj en un directorio de proyecto.Required when there is more than one xproj in a project directory.

EjemplosExamples

Migrar un proyecto del directorio actual y todas sus dependencias de proyecto a proyecto:Migrate a project in the current directory and all of its project-to-project dependencies:

dotnet migrate

Migrar todos los proyectos que incluyen el archivo global.json:Migrate all projects that global.json file includes:

dotnet migrate path/to/global.json

Migrar solo el proyecto actual y ninguna dependencia de proyecto a proyecto (P2P).Migrate only the current project and no project-to-project (P2P) dependencies. Además, usar una versión específica de SDK:Also, use a specific SDK version:

dotnet migrate -s -v 1.0.0-preview4