Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)
(시리즈 글이 4개 있습니다.)
.NET Framework: 975. .NET Core를 직접 호스팅해 (runtimeconfig.json 없이) EXE만 배포해 실행
; https://www.sysnet.pe.kr/2/0/12427

.NET Framework: 992. C# - .NET Core 3.0 이상부터 제공하는 runtimeOptions의 rollForward 옵션
; https://www.sysnet.pe.kr/2/0/12471

.NET Framework: 1165. .NET Core/5+ 빌드 시 runtimeconfig.json에 설정을 반영하는 방법
; https://www.sysnet.pe.kr/2/0/12983

.NET Framework: 2096. .NET Core/5+ - PublishSingleFile 유형에 대한 runtimeconfig.json 설정
; https://www.sysnet.pe.kr/2/0/13265




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 도구가 그다지 도움이 안 되는 경우가 많습니다. ^^




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

[연관 글]






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

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

비밀번호

댓글 작성자
 



2022-03-07 09시25분
dotnet 명령으로 사용하고 싶은 dotnet 버전을 지정
; https://docs.google.com/document/d/e/2PACX-1vQRuOMYIvzl_6hElLya0aA3TyCfw6GsqWZG5Ub8P3heh4M5wUyhohV9kN_oILoGMwcz6wjRLROYgQXI/pub

--------------------

rollForward 옵션을 csproj에서도 지원하고,

Rolling Forward to Major Versions in .NET
; https://weblog.west-wind.com/posts/2023/Oct/02/Rolling-Forward-to-Major-Versions-in-NET

<RollForward>LatestMajor</RollForward>

dotnet 실행 파일에서도 --roll-forward 옵션을 지원합니다.

Options for running an application (--roll-forward <SETTING>)
; https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet#options-for-running-an-application

$ dotnet --roll-forward LatestMajor ConsoleApp1.dll
정성태

... 91  92  93  94  95  96  97  98  [99]  100  101  102  103  104  105  ...
NoWriterDateCnt.TitleFile(s)
11498정성태4/17/201820284개발 환경 구성: 366. Azure Active Directory(Microsoft Enfra ID)의 사용자 유형 구분 - Guest/Member
11497정성태4/17/201817958개발 환경 구성: 365. Azure 리소스의 액세스 제어(Access control) 별로 사용자에게 권한을 할당하는 방법 [2]
11496정성태4/17/201818497개발 환경 구성: 364. Azure Portal에서 구독(Subscriptions) 메뉴가 보이지 않는 경우
11495정성태4/16/201820169개발 환경 구성: 363. Azure의 Access control 보안과 Azure Active Directory의 계정 관리 서비스
11494정성태4/16/201816515개발 환경 구성: 362. Azure Web Apps(App Services)에 사용자 DNS를 지정하는 방법
11493정성태4/16/201818305개발 환경 구성: 361. Azure Web App(App Service)의 HTTP/2 프로토콜 지원
11492정성태4/13/201816310개발 환경 구성: 360. Azure Active Directory의 사용자 도메인 지정 방법
11491정성태4/13/201819636개발 환경 구성: 359. Azure 가상 머신에 Web Application을 배포하는 방법
11490정성태4/12/201818495.NET Framework: 739. .NET Framework 4.7.1의 새 기능 - Configuration builders [1]파일 다운로드1
11489정성태4/12/201816215오류 유형: 463. 윈도우 백업 오류 - a Volume Shadow Copy Service operation failed.
11488정성태4/12/201820012오류 유형: 462. Unhandled Exception in Managed Code Snap-in - FX:{811FD892-5EB4-4E73-A147-F1E079E36C4E}
11487정성태4/12/201818123디버깅 기술: 115. windbg - 닷넷 메모리 덤프에서 정적(static) 필드 값을 조사하는 방법
11486정성태4/11/201817174오류 유형: 461. Error MSB4064 The "ComputeOutputOnly" parameter is not supported by the "VsTsc" task
11485정성태4/11/201825406.NET Framework: 738. C# - Console 프로그램이 Ctrl+C 종료 시점을 감지하는 방법파일 다운로드1
11484정성태4/11/201826843.NET Framework: 737. C# - async를 Task 타입이 아닌 사용자 정의 타입에 적용하는 방법파일 다운로드1
11483정성태4/10/201830035개발 환경 구성: 358. "Let's Encrypt"에서 제공하는 무료 SSL 인증서를 IIS에 적용하는 방법 (2) [1]
11482정성태4/10/201821817VC++: 126. CUDA Core 수를 알아내는 방법
11481정성태4/10/201834474개발 환경 구성: 357. CUDA의 인덱싱 관련 용어 - blockIdx, threadIdx, blockDim, gridDim
11480정성태4/9/201824304.NET Framework: 736. C# - API를 사용해 Azure에 접근하는 방법 [2]파일 다운로드1
11479정성태4/9/201819061.NET Framework: 735. Azure - PowerShell로 Access control(IAM)에 새로운 계정 만드는 방법
11478정성태11/8/201922104디버깅 기술: 115. windbg - 덤프 파일로부터 PID와 환경변수 등의 정보를 구하는 방법 [1]
11477정성태4/8/201819061오류 유형: 460. windbg - sos 명령어 수행 시 c0000006 오류 발생
11476정성태4/8/201820392디버깅 기술: 114. windbg - !threads 출력 결과로부터 닷넷 관리 스레드(System.Threading.Thread) 객체를 구하는 방법
11475정성태3/28/201823267디버깅 기술: 113. windbg - Thread.Suspend 호출 시 응용 프로그램 hang 현상에 대한 덤프 분석
11474정성태3/27/201821533오류 유형: 459. xperf: error: TEST.Event: Invalid flags. (0x3ec).
11473정성태3/22/201826642.NET Framework: 734. C# - Thread.Suspend 호출 시 응용 프로그램 hang 현상파일 다운로드2
... 91  92  93  94  95  96  97  98  [99]  100  101  102  103  104  105  ...