migrar dotnet

Este artigo se aplica a: ✔️ SDK do .NET Core 2.x

Nome

dotnet migrate – Migra um projeto do .NET Core da Versão Prévia 2 para um projeto no estilo SDK do .NET Core.

Sinopse

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

Descrição

Este comando foi preterido. O comando dotnet migrate não está mais disponível a partir do SDK do .NET Core 3.0. Ele só pode migrar um projeto do .NET Core da Versão Prévia 2 para um projeto do .NET Core 1.x, que está sem suporte.

Por padrão, o comando migra o projeto raiz e todas as referências de projeto que o projeto raiz contém. Esse comportamento é desabilitado usando a opção --skip-project-references em tempo de execução.

A migração pode ser executada nos seguintes ativos:

• Um único projeto especificando o arquivo project.json a ser migrado.
• Todos os diretórios especificados no arquivo global.json passando um caminho para o arquivo global.json.
• Um solution.sln(x) arquivo, em que ele migra os projetos referenciados na solução.
• Em todos os subdiretórios do diretório fornecido de forma recursiva.

O comando dotnet migrate mantém o arquivo de project.json migrado dentro de um diretório backup, que ele cria se o diretório não existir. Esse comportamento é substituído usando a opção --skip-backup.

Por padrão, a operação de migração gera o estado do processo de migração para STDOUT (saída padrão). Se você usar a opção --report-file <REPORT_FILE>, a saída será salva no arquivo especificado.

O comando dotnet migrate dá suporte apenas a projetos válidos baseados em project.jsonda Versão Prévia 2. Isso significa que você não pode usá-lo para migrar o DNX ou a Versão Prévia 1 project.jsonprojetos baseados diretamente para projetos do MSBuild/csproj. Primeiro, você precisa migrar manualmente o projeto para um projeto baseado em project.jsonversão prévia 2 e, em seguida, usar o comando dotnet migrate para migrar o projeto.

Argumentos

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

O caminho para um dos seguintes:

• um arquivo project.json a ser migrado.
• um arquivo global.json: as pastas especificadas em global.json são migradas.
• um arquivo solution.sln(x): os projetos referenciados na solução são migrados.
• um diretório a ser migrado: pesquisa recursivamente arquivos project.json para migrar dentro do diretório especificado.

O padrão será o diretório atual se nada for especificado.

Opções

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

Arquivo de relatório de migração de saída como JSON em vez de mensagens de usuário.

-h|--help

Imprime uma breve ajuda para o comando.

-r|--report-file <REPORT_FILE>

Relatório de migração de saída para um arquivo além do console.

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

Ignore as referências de projeto de migração. Por padrão, as referências de projeto são migradas recursivamente.

--skip-backup

Ignore mover project.json, global.jsone *.xproj para um diretório backup após a migração bem-sucedida.

-t|--template-file <TEMPLATE_FILE>

Arquivo csproj de modelo a ser usado para migração. Por padrão, o mesmo modelo que o descartado por dotnet new console é usado.

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

A versão do pacote sdk referenciada no aplicativo migrado. O padrão é a versão do SDK em dotnet new.

-x|--xproj-file <FILE>

O caminho para o arquivo xproj a ser usado. Obrigatório quando há mais de um xproj em um diretório de projeto.

Exemplos

Migre um projeto no diretório atual e todas as dependências de projeto para projeto:

dotnet migrate

Migrar todos os projetos que global.json arquivo inclui:

dotnet migrate path/to/global.json

Migre apenas o projeto atual e nenhuma dependência de projeto para projeto (P2P). Além disso, use uma versão específica do SDK:

dotnet migrate -s -v 1.0.0-preview4