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