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