다음을 통해 공유


.NET 업그레이드 도우미를 사용하여 프로젝트 업그레이드

이 문서의 핵심은 .NET 업그레이드 도우미를 사용하여 프로젝트를 업그레이드하는 기본 단계를 제공하는 것입니다. 여기에는 업그레이드를 시작하고 결과를 검토하는 작업이 포함됩니다. 프로젝트가 얼마나 복잡한지에 따라 코드에 대한 수동 업데이트를 수행해야 할 수 있습니다.

일부 프로젝트 형식에는 업그레이드에 대한 특정 지침이 있습니다. 자세한 내용은 지원되는 프로젝트 형식을 참조 하세요.

필수 조건

Visual Studio에서 프로젝트 업그레이드

Visual Studio에서 프로젝트를 업그레이드하려면 다음 단계를 수행합니다.

  1. 코드를 백업합니다.

  2. Visual Studio를 엽니다.

  3. 프로젝트 또는 솔루션을 엽니다.

  4. 솔루션 탐색기 창에서 프로젝트>를 마우스 오른쪽 단추로 클릭합니다.

    프로젝트의 오른쪽 클릭 메뉴를 보여 주는 Visual Studio의 솔루션 탐색기 창입니다. 업그레이드 메뉴 항목이 강조 표시됩니다.

  5. 업그레이드 탭에서 적절한 업그레이드 옵션을 선택합니다.

    프로젝트 유형 및 대상 프레임워크 버전에 따라 다양한 옵션이 제공됩니다. 다음 이미지는 .NET Framework용 Windows Forms 프로젝트를 업그레이드할 때 두 가지 옵션을 보여 줍니다. .NET 프로젝트를 업그레이드할 때는 이러한 옵션이 표시되지 않습니다.

    Visual Studio의 .NET 업그레이드 도우미 시작 화면.

    이 예제에서는 프로젝트를 최신 .NET 버전으로 업그레이드를 선택합니다.

  6. 업그레이드를 수행할 방법을 선택합니다. 현재 위치 프로젝트 업그레이드를 선택한 다음, 다음을 선택합니다.

    일부 프로젝트에서는 단일 옵션만 표시할 수 있습니다. 이러한 옵션에 대한 자세한 내용은 업그레이드를 수행하는 방법을 참조하세요.

    '업그레이드 유형이란?' 선택을 보여 주는 .NET 업그레이드 도우미 마법사입니다. '다음' 단추와 마찬가지로 '현재 위치 프로젝트 업그레이드'가 강조 표시됩니다.

  7. 대상 프레임워크(예 : .NET 8.0)를 선택합니다. 그런 후에 다음을 선택합니다.

    '기본 설정 대상 프레임워크란?' 선택을 보여 주는 .NET 업그레이드 도우미 마법사 '.NET 8.0'이 '다음' 단추처럼 강조 표시됩니다.

  8. 업그레이드할 구성 요소를 선택한 다음 업그레이드 선택을 선택합니다.

    '업그레이드할 구성 요소 선택' 선택을 보여 주는 .NET 업그레이드 도우미 마법사. '업그레이드 선택' 단추와 마찬가지로 구성 요소 목록이 강조 표시됩니다.

  9. 업그레이드가 완료되면 처리된 항목 목록이 표시됩니다.

    요약 화면을 보여 주는 .NET 업그레이드 도우미 마법사입니다. 업그레이드에서 처리되는 각 아티팩트가 상태 아이콘과 함께 나열됩니다.

업그레이드에서 처리된 각 아티팩트가 해당 상태와 함께 나열됩니다. 자세한 내용은 업그레이드 결과를 참조하세요.

CLI에서 프로젝트 업그레이드

터미널을 사용하여 프로젝트를 업그레이드하려면 다음 단계를 수행합니다. .NET 전역 도구는 업그레이드 옵션을 안내하는 대화형 도구입니다. 위쪽 화살표 키와 아래쪽 화살표 키를 사용하여 강조 표시된 옵션을 변경하고 Enter 키를 사용하여 옵션 선택을 실행합니다. 각 화면에는 업그레이드를 구성하는 방법에 대한 옵션이 표시됩니다.

  1. 코드를 백업합니다.

  2. 터미널을 열고 업그레이드할 솔루션 또는 프로젝트가 포함된 폴더로 이동합니다.

  3. 도구를 시작하려면 명령을 실행합니다 upgrade-assistant upgrade .

    업그레이드할 항목에 대한 메시지가 표시됩니다. 검색된 내용에 따라 일부 옵션이 자동으로 적용되거나 완전히 누락될 수 있습니다.

    .NET 업그레이드 도우미 전역 도구에 대한 옵션의 초기 화면을 보여 주는 터미널입니다. '어떤 프로젝트를 업그레이드하시겠습니까'라는 질문을 받고 있습니다.

  4. 프로젝트가 두 개 이상 있으면 프로젝트 중 하나를 선택하고 Enter 키를 누릅니 .

    종속성 순서대로 프로젝트를 업그레이드합니다. 예를 들어 이전 이미지에는 두 개의 프로젝트가 MatchingGame 표시되었습니다 MatchingGame.Logic. MatchingGame 가 종 MatchingGame.Logic속되어 있으므로 MatchingGame.Logic 먼저 업그레이드해야 합니다.

  5. 업그레이드 유형을 변경하는 옵션이 있는 경우 하나를 선택하고 Enter 키를 누릅니. 사용할 수 있는 옵션이 하나만 있으면 자동으로 선택되었을 것입니다.

    이러한 옵션에 대한 자세한 내용은 업그레이드를 수행하는 방법을 참조하세요.

    코드를 백업한 경우 현재 위치 프로젝트 업그레이드를 선택하는 것이 안전합니다.

  6. .NET 8.0과 같은 대상 프레임워크를 선택하고 Enter 키를 누릅니.

  7. 최종 프롬프트는 선택한 모든 옵션을 표시하는 확인입니다. Enter 키를 눌러 업그레이드를 시작합니다.

    .NET 업그레이드 도우미 전역 도구에 대한 옵션의 요약 화면을 보여 주는 터미널입니다. 사용자에게 계속하라는 메시지가 표시됩니다.

  8. 업그레이드가 완료되면 요약이 표시됩니다.

    .NET 업그레이드 도우미 전역 도구를 사용할 때 업그레이드 명령의 결과를 보여 주는 터미널입니다.