dotnet migrate
Este artículo se aplica a: ✔️ SDK de .NET Core 2.x
Nombre
dotnet migrate
: migra un proyecto de .NET Core de versión preliminar 2 a un proyecto de estilo SDK de .NET Core.
Sinopsis
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
Descripción
Este comando está en desuso. El comando dotnet migrate
ya no está disponible a partir del SDK de .NET Core 3.0. Solo puede migrar un proyecto de .NET Core de versión preliminar 2 a un proyecto de .NET Core 1.x, que no es compatible.
De forma predeterminada, el comando migra el proyecto raíz y cualquier referencia de proyecto que contenga el proyecto raíz. Este comportamiento está deshabilitado mediante la opción --skip-project-references
en tiempo de ejecución.
La migración se puede realizar en los siguientes recursos:
- Un solo proyecto especificando el archivo project.json que se va a migrar.
- Todos los directorios especificados en el archivo global.json pasando una ruta de acceso al archivo global.json.
- Un archivo solution.sln(x), donde migra los proyectos a los que se hace referencia en la solución.
- En todos los subdirectorios del directorio especificado de forma recursiva.
El comando dotnet migrate
mantiene el archivo project.json migrado dentro de un directorio backup
, que crea si el directorio no existe. Este comportamiento se invalida mediante la opción --skip-backup
.
De forma predeterminada, la operación de migración genera el estado del proceso de migración en la salida estándar (STDOUT). Si usa la opción --report-file <REPORT_FILE>
, la salida se guarda en el archivo especificado.
El comando dotnet migrate
solo admite proyectos válidos basados en la versión preliminar 2 project.json. Esto significa que no se puede usar para migrar proyectos basados en DNX o Versión preliminar 1 project.jsondirectamente a proyectos de MSBuild/csproj. Primero debe migrar manualmente el proyecto a un proyecto basado en la versión preliminar 2 project.jsony, a continuación, usar el comando dotnet migrate
para migrar el proyecto.
Argumentos
PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR
La ruta de acceso a una de las siguientes opciones:
- un archivo project.json que se va a migrar.
- un archivo global.json: se migran las carpetas especificadas en global.json.
- un archivo solution.sln(x): se migran los proyectos a los que se hace referencia en la solución.
- un directorio que se va a migrar: busca de forma recursiva archivos project.json para migrar dentro del directorio especificado.
El valor predeterminado es el directorio actual si no se especifica nada.
Opciones
--format-report-file-json <REPORT_FILE>
Archivo de informe de migración de salida como JSON en lugar de mensajes de usuario.
-h|--help
Imprime una breve ayuda para el comando.
-r|--report-file <REPORT_FILE>
Informe de migración de salida a un archivo además de la consola.
-s|--skip-project-references [Debug|Release]
Omita la migración de referencias de proyecto. De forma predeterminada, las referencias de proyecto se migran de forma recursiva.
--skip-backup
Omita mover project.json, global.jsony *.xproj a un directorio de backup
después de una migración correcta.
-t|--template-file <TEMPLATE_FILE>
Archivo csproj de plantilla que se va a usar para la migración. De forma predeterminada, se usa la misma plantilla que la que quita dotnet new console
.
-v|--sdk-package-version <VERSION>
Versión del paquete del SDK al que se hace referencia en la aplicación migrada. El valor predeterminado es la versión del SDK en dotnet new
.
-x|--xproj-file <FILE>
Ruta de acceso al archivo xproj que se va a usar. Obligatorio cuando hay más de un xproj en un directorio de proyecto.
Ejemplos
Migre un proyecto en el directorio actual y todas sus dependencias de proyecto a proyecto:
dotnet migrate
Migre todos los proyectos que global.json archivo incluyen:
dotnet migrate path/to/global.json
Migre solo el proyecto actual y ninguna dependencia de proyecto a proyecto (P2P). Además, use una versión específica del SDK:
dotnet migrate -s -v 1.0.0-preview4