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
묘사
이 명령은 더 이상 사용되지 않습니다.
dotnet migrate
명령은 .NET Core 3.0 SDK부터 더 이상 사용할 수 없습니다. 미리 보기 2 .NET Core 프로젝트만 지원되지 않는 1.x .NET Core 프로젝트로 마이그레이션할 수 있습니다.
기본적으로 이 명령은 루트 프로젝트와 루트 프로젝트에 포함된 모든 프로젝트 참조를 마이그레이션합니다. 이 동작은 런타임에 --skip-project-references
옵션을 사용하여 사용하지 않도록 설정됩니다.
마이그레이션은 다음 자산에 대해 수행할 수 있습니다.
- 마이그레이션할 project.json 파일을 지정하여 단일 프로젝트입니다.
- global.json 파일에 대한 경로를 전달하여 global.json 파일에 지정된 모든 디렉터리입니다.
- 솔루션에서 참조되는 프로젝트를 마이그레이션하는 solution.sln(x) 파일입니다.
- 지정된 디렉터리의 모든 하위 디렉터리에서 재귀적으로.
dotnet migrate
명령은 마이그레이션된 project.json 파일을 디렉터리가 없는 경우 만드는 backup
디렉터리 내에 유지합니다. 이 동작은 --skip-backup
옵션을 사용하여 재정의됩니다.
기본적으로 마이그레이션 작업은 마이그레이션 프로세스의 상태를 표준 출력(STDOUT)으로 출력합니다.
--report-file <REPORT_FILE>
옵션을 사용하면 출력이 파일 지정에 저장됩니다.
dotnet migrate
명령은 유효한 Preview 2 project.json기반 프로젝트만 지원합니다. 즉, DNX 또는 Preview 1 project.json-based 프로젝트를 MSBuild/csproj 프로젝트로 직접 마이그레이션하는 데 사용할 수 없습니다. 먼저 프로젝트를 Preview 2 project.json기반 프로젝트로 수동으로 마이그레이션한 다음 dotnet migrate
명령을 사용하여 프로젝트를 마이그레이션해야 합니다.
인수
PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR
다음 중 하나에 대한 경로입니다.
- 마이그레이션할 project.json 파일입니다.
- global.json 파일: global.json 지정된 폴더가 마이그레이션됩니다.
- solution.sln(x) 파일: 솔루션에서 참조되는 프로젝트가 마이그레이션됩니다.
- 마이그레이션할 디렉터리: 지정된 디렉터리 내에서 마이그레이션할 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및 *.xprojbackup
디렉터리로 이동하는 것을 건너뜁니다.
-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
.NET