dotnet migrate

本文适用于:✔️ .NET Core 2.x SDK

“属性”

dotnet migrate - 将预览版 2 .NET Core 项目迁移到 .NET Core SDK 样式的项目中。

摘要

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

描述

此命令已弃用。 自 .NET Core 3.0 SDK 起,dotnet migrate 命令不再可用。 它只能将预览版 2 .NET Core 项目迁移到不支持的 1.x .NET Core 项目。

默认情况下,命令迁移根项目和根项目包含的任何项目引用。 在运行时使用 --skip-project-references 选项禁用此行为。

可在下列资产上执行迁移:

  • 通过指定 project.json 文件进行迁移的单个项目。
  • 通过将路径传递到 global.json 文件在 global.json 文件中指定的所有目录。
  • 一个 solution.sln 文件,它迁移在解决方案中引用的项目。
  • 以递归方式迁移给定目录的所有子目录。

dotnet migrate 命令将迁移的 project.json 文件保存在 backup 目录中,如果该目录不存在,将创建一个。 使用 --skip-backup 选项重写此行为。

默认情况下,迁移操作会将迁移过程的状态输出到标准输出 (STDOUT)。 如果使用 --report-file <REPORT_FILE> 选项,输出将保存到指定的文件中。

dotnet migrate 命令仅支持有效的预览版 2 基于 project.json 的项目。 这意味着,不能使用它将 DNX 或预览版 1 基于 project.json 的项目直接迁移到 MSBuild/csproj 项目。 首先需要将项目手动迁移到预览版 2 基于 project.json 的项目,然后使用 dotnet migrate 命令迁移该项目。

自变量

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

下列路径之一:

  • 要迁移的 project.json 文件。
  • global.json 文件:迁移在 global.json 中指定的文件夹 。
  • solution.sln 文件:迁移该解决方案中引用的项目。
  • 要迁移的目录:在指定的目录中以递归方式搜索要迁移的 project.json 文件。

如未指定,则默认为当前目录。

选项

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

将迁移报告文件(而非用户消息)作为 JSON 输出。

-h|--help

打印出有关命令的简短帮助。

-r|--report-file <REPORT_FILE>

除控制台外,还将迁移报告输出到文件。

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

跳过迁移项目引用。 默认情况下,以递归方式迁移项目引用。

--skip-backup

在成功迁移后,跳过将 project.json、global.json 和 *.xproj 移动到 backup 目录的步骤。

-t|--template-file <TEMPLATE_FILE>

用于迁移的模板 csproj 文件。 默认情况下,使用与被 dotnet new console 删除的模板相同的模板。

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

在已迁移应用中将被引用的 sdk 包的版本。 默认为 dotnet new 中 SDK 的版本。

-x|--xproj-file <FILE>

要使用的 xproj 文件的路径。 当项目目录中有多个 xproj 时需要。

示例

将当前目录中的项目及其所有项目迁移到项目依赖项:

dotnet migrate

迁移 global.json 文件所包含的所有项目:

dotnet migrate path/to/global.json

仅迁移当前项目,不迁移项目到项目 (P2P) 的依赖项。 此外,使用特定的 SDK 版本:

dotnet migrate -s -v 1.0.0-preview4