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 도구가 그다지 도움이 안 되는 경우가 많습니다. ^^
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]