다음을 통해 공유


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 newSDK의 버전입니다.

-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