Partilhar via


dotnet migrate

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

Name

dotnet migrate - Migra um projeto .NET Core de Pré-visualização 2 para um projeto de estilo SDK .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

Description

Este comando foi preterido. O dotnet migrate comando já não está disponível a partir do SDK .NET Core 3.0. Só pode migrar um projeto .NET Core de Pré-visualização 2 para um projeto .NET Core 1.x, que não tem suporte.

Por predefinição, o comando migra o projeto de raiz e quaisquer referências de projeto que o projeto de raiz contenha. Este comportamento é desativado com a opção --skip-project-references no tempo de execução.

A migração pode ser efetuada nos seguintes recursos:

  • Um único projeto ao especificar o ficheiro project.json a migrar.
  • Todos os diretórios especificados no ficheiro global.json ao transmitir um caminho para o ficheiro global.json .
  • Um ficheiro solution.sln , onde migra os projetos referenciados na solução.
  • Em todos os subdiretórios do diretório especificado recursivamente.

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

Por predefinição, a operação de migração produz o estado do processo de migração para a saída padrão (STDOUT). Se utilizar a opção --report-file <REPORT_FILE> , a saída é guardada no ficheiro especificado.

O dotnet migrate comando só suporta projetos baseados em project.json de Pré-visualização 2 válidos. Isto significa que não pode utilizá-lo para migrar projetos baseados em DNX ou Pré-visualização 1 baseados em project.json diretamente para projetos MSBuild/csproj. Primeiro, tem de migrar manualmente o projeto para um projeto baseado em Project.json de Pré-visualização 2 e, em seguida, utilizar o dotnet migrate comando para migrar o projeto.

Argumentos

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

O caminho para um dos seguintes:

  • um ficheiro project.json para migrar.
  • um ficheiro global.json : as pastas especificadas em global.json são migradas.
  • um ficheiro solution.sln : os projetos referenciados na solução são migrados.
  • um diretório para migrar: procura recursivamente ficheiros project.json para migrar dentro do diretório especificado.

A predefinição é o diretório atual se nada for especificado.

Opções

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

Ficheiro de relatório de migração de saída como JSON em vez de mensagens de utilizador.

-h|--help

Imprime uma breve ajuda para o comando .

-r|--report-file <REPORT_FILE>

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

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

Ignorar a migração de referências de projeto. Por predefinição, as referências de projeto são migradas recursivamente.

--skip-backup

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

-t|--template-file <TEMPLATE_FILE>

Ficheiro csproj de modelo a utilizar para migração. Por predefinição, é utilizado o mesmo modelo que o modelo ignorado.dotnet new console

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

A versão do pacote sdk referenciada na aplicação migrada. A predefinição é a versão do SDK no dotnet new.

-x|--xproj-file <FILE>

O caminho para o ficheiro xproj a utilizar. Necessário quando existe mais de um xproj num diretório de projeto.

Exemplos

Migrar um projeto no diretório atual e em todas as dependências projeto a projeto:

dotnet migrate

Migrar todos os projetos que o ficheiro global.json inclui:

dotnet migrate path/to/global.json

Migrar apenas o projeto atual e sem dependências de projeto para projeto (P2P). Além disso, utilize uma versão específica do SDK:

dotnet migrate -s -v 1.0.0-preview4