Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

C# - .NET Core 3.0 이상부터 제공하는 runtimeOptions의 rollForward 옵션

Framework-dependent 방식으로 배포하는 경우, runtimeconfig.json에 담긴 내용에 따라 dotnet 호스팅의 런타임이 결정됩니다.

기본적으로 "Target framework"을 .NET Core 2.0으로 설정했으면 빌드 후 runtimeconfig.json은 다음과 같이 구성됩니다.

{
  "runtimeOptions": {
    "tfm": "netcoreapp2.0",
    "framework": {
      "name": "Microsoft.NETCore.App",
      "version": "2.0.0"
    }
  }
}

하지만, 이 응용 프로그램을 .NET 5.0만 설치된 환경에서 실행하면 이런 식의 오류 메시지가 발생합니다.

C:\temp> dotnet ConsoleApp1.dll
It was not possible to find any compatible framework version
The framework 'Microsoft.NETCore.App', version '2.0.0' was not found.
  - The following frameworks were found:
      5.0.1 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]

You can resolve the problem by installing the specified framework and/or SDK.

The specified framework can be found at:
  - https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_v

이를 극복하려면 텍스트 파일인 runtimeconfig.json의 framework.version 속성을 그에 맞게 편집해야 합니다.

{
  "runtimeOptions": {
    "tfm": "netcoreapp2.0",
    "framework": {
      "name": "Microsoft.NETCore.App",
      "version": "5.0.0"
    }
  }
}

이러한 버전 실행 정책에 대한 보다 구체적인 설명은 아래의 문서로 찾아볼 수 있습니다.

Select the .NET Core version to use
; https://docs.microsoft.com/en-us/dotnet/core/versions/selection

A few usage examples demonstrate the behavior, if you target 3.0:

(O) 3.0 is specified. 3.0.3 is the highest patch version installed. 3.0.3 is used.
(X) 3.0 is specified. No 3.0.* versions are installed. 2.1.1 is the highest runtime installed. An error message is displayed.
(O) 3.0 is specified. No 3.0.* versions are installed. 3.1.0 is the highest runtime version installed. 3.1.0 is used.
(X) 2.0 is specified. No 2.x versions are installed. 3.0.0 is the highest runtime installed. An error message is displayed.




그런데, .NET Framework의 경우 .NET 2.0으로 만든 바이너리도 supportedRuntime만 잘 지정해 주면 .NET 4.0에서도 자연스럽게 실행하는 기능이 있습니다.

<?xml version="1.0"?>
<configuration>
    <startup>
        <supportedRuntime version="v4.0.30319"/> 
        <supportedRuntime version="v2.0.50727"/>
    </startup>
</configuration>

아쉽게도 초기 .NET Core에는 그런 설정이 없었지만 .NET Core 3.0 이후부터 rollForward 옵션이 추가되었습니다. 따라서 다음과 같이 설정해 둔 경우,

{
  "runtimeOptions": {
    "tfm": "netcoreapp2.0",
    "rollForward": "Major",
    "framework": {
      "name": "Microsoft.NETCore.App",
      "version": "3.0.0"
    }
  }
}

Major 버전이 다른 .NET 5 환경만 설치된 상태에서도 정상적으로 실행이 됩니다. (그뿐만 아니라 향후 .NET 6이 나왔을 때에도 아무런 변경 없이 기존 프로그램이 잘 실행될 것입니다.) 좀 더 자세한 내용은 다음의 글에서 확인할 수 있습니다.

Deep-dive into .NET Core primitives, part 3: runtimeconfig.json in depth
; https://natemcmaster.com/blog/2019/01/09/netcore-primitives-3/

(그 외에, "applyPatches", "rollForwardOnNoCandidateFx" 옵션도 있습니다.)




참고로, 이번 기회에 dotnet-core-uninstall 도구를 소개합니다. ^^

Announcing the .NET Core Uninstall Tool 1.0!
; https://devblogs.microsoft.com/dotnet/announcing-the-net-core-uninstall-tool-1-0/

(윈도우의 경우 msi 설치 후) 제거할 수 있는 .NET Core 버전을 "list" 옵션으로 확인할 수 있습니다.

C:\temp> dotnet-core-uninstall list

This tool can not uninstall versions of the runtime or SDK that are?
    - SDKs installed using Visual Studio 2019 Update 3 or later.
    - SDKs and runtimes installed via zip/scripts.
    - Runtimes installed with SDKs (these should be removed by removing that SDK). 
The versions that can be uninstalled with this tool are:

.NET Core SDKs:
  1.1.14  x86

  1.1.14  x64    [Used by Visual Studio. Specify individually or use ?-force to remove]

.NET Core Runtimes:

ASP.NET Core Runtimes:

.NET Core Runtime & Hosting Bundles:

그런데, 메시지에 나오는 것처럼 사실 만능은 아니라서 Visual Studio, zip/script 또는 SDK와 함께 설치된 런타임은 제거하지 못한다는 한계가 있습니다. 실제로 위의 실행 결과를 보인 환경에서 "dotnet --list-runtimes" 명령어로는 더 많은 버전이 설치된 것을 확인할 수 있었습니다.

C:\temp>dotnet --list-runtimes
Microsoft.AspNetCore.All 2.1.23 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.All]
Microsoft.AspNetCore.App 2.1.23 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 3.1.9 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 5.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
Microsoft.NETCore.App 1.0.16 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 1.1.13 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 2.1.23 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 3.1.9 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.NETCore.App 5.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Microsoft.WindowsDesktop.App 3.1.9 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
Microsoft.WindowsDesktop.App 5.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]

결국, dotnet-core-uninstall 도구가 그다지 도움이 안 되는 경우가 많습니다. ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]



donaricano-btn



[최초 등록일: ]
[최종 수정일: 1/1/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 쓴 사람
 




1  2  3  4  5  6  7  8  9  10  11  12  13  14  [15]  ...
NoWriterDateCnt.TitleFile(s)
12500정성태1/21/20211002.NET Framework: 1014. ASP.NET Core(Kestrel)의 HTTP/2 지원 여부파일 다운로드1
12499정성태1/20/20211263.NET Framework: 1013. .NET Core Kestrel 호스팅 - 포트 변경, non-localhost 접속 지원 및 https 등의 설정 변경파일 다운로드1
12498정성태1/20/20211059.NET Framework: 1012. .NET Core Kestrel 호스팅 - 비주얼 스튜디오의 Kestrel/IIS Express 프로파일 설정
12497정성태1/20/20211329.NET Framework: 1011. C# - OWIN Web API 예제 프로젝트 [1]파일 다운로드2
12496정성태1/19/20211240.NET Framework: 1010. .NET Core 콘솔 프로젝트에서 Kestrel 호스팅 방법 [1]
12495정성태1/19/20211680웹: 40. IIS의 HTTP/2 지원 여부 - h2, h2c [1]
12494정성태1/19/20211371개발 환경 구성: 522. WSL2 인스턴스와 호스트 측의 Hyper-V에 운영 중인 VM과 네트워크 연결을 하는 방법 [2]
12493정성태1/18/20211129.NET Framework: 1009. .NET 5에서의 네트워크 라이브러리 개선 (1) - HTTP 관련 [1]파일 다운로드1
12492정성태1/17/2021922오류 유형: 695. ASP.NET 0x80131620 Failed to bind to address
12491정성태1/16/20211220.NET Framework: 1008. 배열을 반환하는 C# COM 개체의 메서드를 C++에서 사용 시 메모리 누수 현상 [1]파일 다운로드1
12490정성태1/15/20211404.NET Framework: 1007. C# - foreach에서 열거 변수의 타입을 var로 쓰면 object로 추론하는 문제 [1]파일 다운로드1
12489정성태1/13/20211788.NET Framework: 1006. C# - DB에 저장한 텍스트의 (이모티콘을 비롯해) 유니코드 문자가 '?'로 보인다면?
12488정성태1/13/20211372.NET Framework: 1005. C# - string 타입은 shallow copy일까요? deep copy일까요?파일 다운로드1
12487정성태1/13/20211073.NET Framework: 1004. C# - GC Heap에 위치한 참조 개체의 주소를 알아내는 방법파일 다운로드1
12486정성태1/12/20211217.NET Framework: 1003. x64 환경에서 참조형의 기본 메모리 소비는 얼마나 될까요?
12485정성태1/11/20211481Graphics: 38. C# - OpenCvSharp.VideoWriter에 BMP 파일을 1초씩 출력하는 예제파일 다운로드1
12484정성태1/9/20211547.NET Framework: 1002. C# - ReadOnlySequence<T> 소개파일 다운로드1
12483정성태1/8/20211132개발 환경 구성: 521. dotPeek - 훌륭한 역어셈블 소스 코드 생성 도구
12482정성태1/8/20211107.NET Framework: 1001. C# - 제네릭 타입/메서드에서 사용 시 경우에 따라 CS8377 컴파일 에러
12481정성태1/7/20211111.NET Framework: 1000. C# - CS8344 컴파일 에러: ref struct 타입의 사용 제한 메서드파일 다운로드1
12480정성태1/6/20211528.NET Framework: 999. C# - ArrayPool<T>와 MemoryPool<T> 소개파일 다운로드1
12479정성태1/6/20211087.NET Framework: 998. C# - OWIN 예제 프로젝트 만들기
12478정성태1/5/20211332.NET Framework: 997. C# - ArrayPool<T> 소개파일 다운로드1
12477정성태1/5/20212477기타: 79. github 코드 검색 방법 [1]
12476정성태1/5/20211333.NET Framework: 996. C# - 닷넷 코어에서 다른 스레드의 callstack을 구하는 방법파일 다운로드1
12475정성태1/5/20211393.NET Framework: 995. C# - Span<T>와 Memory<T> [1]파일 다운로드1
1  2  3  4  5  6  7  8  9  10  11  12  13  14  [15]  ...