Compartir a través de

dotnet migrate

  • Artículo

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