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)
12749정성태8/2/202124개발 환경 구성: 590. Visual Studio 2017부터 단위 테스트에 DataRow 특성 지원
12748정성태8/2/20218개발 환경 구성: 589. Azure Active Directory - tenant의 관리자(admin) 계정 로그인 방법
12747정성태8/1/202128오류 유형: 748. 오류 기록 - MICROSOFT GRAPH – HOW TO IMPLEMENT IAUTHENTICATIONPROVIDER파일 다운로드1
12746정성태7/31/202175개발 환경 구성: 588. 네트워크 장비 환경을 시뮬레이션하는 Packet Tracer 프로그램 소개
12745정성태7/31/202122개발 환경 구성: 587. Azure Active Directory - tenant의 관리자 계정 로그인 방법
12744정성태7/30/202127개발 환경 구성: 586. Azure Active Directory에 연결된 App 목록을 확인하는 방법?
12743정성태7/30/202147.NET Framework: 1083. Azure Active Directory - 외부 Token Cache 저장소를 사용하는 방법파일 다운로드1
12742정성태7/30/202125개발 환경 구성: 585. Azure AD 인증을 위한 사용자 인증 유형
12741정성태7/29/202182.NET Framework: 1082. Azure Active Directory - Microsoft Graph API 호출 방법파일 다운로드1
12740정성태7/29/202138오류 유형: 747. SharePoint - InvalidOperationException 0x80131509
12739정성태7/28/202137오류 유형: 746. Azure Active Directory - IDW10106: The 'ClientId' option must be provided.
12738정성태7/28/202141오류 유형: 745. Azure Active Directory - Client credential flows must have a scope value with /.default suffixed to the resource identifier (application ID URI).
12737정성태7/28/202139오류 유형: 744. Azure Active Directory - The resource principal named api://...[client_id]... was not found in the tenant
12736정성태7/28/202145오류 유형: 743. Active Azure Directory에서 "API permissions"의 권한 설정이 "Not granted for ..."로 나오는 문제
12735정성태7/27/202181.NET Framework: 1081. C# - Azure AD 인증을 지원하는 데스크톱 애플리케이션 예제(Windows Forms)파일 다운로드1
12734정성태7/26/202186스크립트: 20. 특정 단어로 시작하거나/끝나는 문자열을 포함/제외하는 정규 표현식 - Look-around
12733정성태7/23/2021107.NET Framework: 1081. Self-Contained/SingleFile 유형의 .NET Core/5+ 실행 파일을 임베딩한다면?파일 다운로드2
12732정성태7/23/202149오류 유형: 742. SharePoint - The super user account utilized by the cache is not configured.
12731정성태7/23/202171개발 환경 구성: 584. Add Internal URLs 화면에서 "Save" 버튼이 비활성화 된 경우
12730정성태7/23/202173개발 환경 구성: 583. Visual Studio Code - Go 코드에서 입력을 받는 경우
12729정성태7/22/202181.NET Framework: 1080. xUnit 단위 테스트에 메서드/클래스 수준의 문맥 제공 - Fixture
12728정성태7/22/202175.NET Framework: 1079. MSTestv2 단위 테스트에 메서드/클래스/어셈블리 수준의 문맥 제공
12727정성태7/21/2021147.NET Framework: 1078. C# 단위 테스트 - MSTestv2/NUnit의 Assert.Inconclusive 사용법(?)
12726정성태7/21/2021131VS.NET IDE: 169. 비주얼 스튜디오 - 단위 테스트 선택 시 MSTestv2 외의 xUnit, NUnit 사용법
12725정성태7/21/202173오류 유형: 741. Failed to find the "go" binary in either GOROOT() or PATH
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...