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)
12520정성태1/30/2021102개발 환경 구성: 526. 오라클 클라우드의 VM에 ping ICMP 여는 방법
12519정성태1/30/2021124개발 환경 구성: 525. 오라클 클라우드의 VM을 외부에서 접근하기 위해 포트 여는 방법
12518정성태1/30/2021199Linux: 37. Ubuntu에 Wireshark 설치
12517정성태1/30/2021211Linux: 36. 윈도우 클라이언트에서 X2Go를 이용한 원격 리눅스의 GUI 접속 - 우분투 20.04
12516정성태1/29/2021100Windows: 187. Windows - TCP default template 설정 방법
12515정성태1/28/2021185웹: 41. Microsoft Edge - localhost에 대해 http 접근 시 무조건 https로 바뀌는 문제 [3]
12514정성태1/28/2021319.NET Framework: 1021. C# - 일렉트론 닷넷(Electron.NET) 소개파일 다운로드1
12513정성태1/28/202172오류 유형: 698. electronize - User Profile 디렉터리에 공백 문자가 있는 경우 빌드가 실패하는 문제
12512정성태1/28/202185오류 유형: 697. The program can't start because VCRUNTIME140.dll is missing from your computer. Try reinstalling the program to fix this problem.
12511정성태1/28/2021137Windows: 187. Windows - 도스 시절의 8.3 경로를 알아내는 방법
12510정성태1/27/2021154.NET Framework: 1020. .NET Core Kestrel 호스팅 - Razor 지원 추가파일 다운로드1
12509정성태1/27/2021106개발 환경 구성: 524. Jupyter Notebok에서 C#(F#, PowerShell) 언어 사용을 위한 환경 구성
12508정성태1/27/202184개발 환경 구성: 523. Jupyter Notebook - Slide 플레이 버튼이 없는 경우
12507정성태1/26/2021106VS.NET IDE: 1576. Visual Studio - Syntax Visualizer 메뉴가 없는 경우
12506정성태1/25/2021150.NET Framework: 1019. Microsoft.Tye 기본 사용법 소개
12505정성태1/27/2021166.NET Framework: 1018. .NET Core Kestrel 호스팅 - Web API 추가파일 다운로드1
12504정성태1/23/2021246.NET Framework: 1017. .NET 5에서의 네트워크 라이브러리 개선 (2) - HTTP/2, HTTP/3 관련
12503정성태1/21/2021128오류 유형: 696. C# - HttpClient: Requesting HTTP version 2.0 with version policy RequestVersionExact while HTTP/2 is not enabled.
12502정성태1/21/2021174.NET Framework: 1016. .NET Core HttpClient의 HTTP/2 지원파일 다운로드1
12501정성태1/21/2021178.NET Framework: 1015. .NET 5부터 HTTP/1.1, 2.0 선택을 위한 HttpVersionPolicy 동작 방식파일 다운로드1
12500정성태1/21/2021163.NET Framework: 1014. ASP.NET Core(Kestrel)의 HTTP/2 지원 여부파일 다운로드1
12499정성태1/23/2021183.NET Framework: 1013. .NET Core Kestrel 호스팅 - 포트 변경, non-localhost 접속 지원 및 https 등의 설정 변경파일 다운로드1
12498정성태1/23/2021137.NET Framework: 1012. .NET Core Kestrel 호스팅 - 비주얼 스튜디오의 Kestrel/IIS Express 프로파일 설정
12497정성태1/20/2021142.NET Framework: 1011. C# - OWIN Web API 예제 프로젝트파일 다운로드1
12496정성태1/19/2021177.NET Framework: 1010. .NET Core 콘솔 프로젝트에서 Kestrel 호스팅 방법
12495정성태1/20/2021234웹: 40. IIS의 HTTP/2 지원 여부 - h2, h2c [1]
1  [2]  3  4  5  6  7  8  9  10  11  12  13  14  15  ...