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

(시리즈 글이 7개 있습니다.)
개발 환경 구성: 386. .NET Framework Native compiler 프리뷰 버전 사용법
; https://www.sysnet.pe.kr/2/0/11563

.NET Framework: 2069. .NET 7 - AOT(ahead-of-time) 컴파일
; https://www.sysnet.pe.kr/2/0/13162

닷넷: 2175. C# - DllImport 메서드의 AOT 지원을 위한 LibraryImport 옵션
; https://www.sysnet.pe.kr/2/0/13466

닷넷: 2184. C# - 하나의 resource 파일을 여러 프로그램에서 (AOT 시에도) 사용하는 방법
; https://www.sysnet.pe.kr/2/0/13483

개발 환경 구성: 696. C# - 리눅스용 AOT 빌드를 docker에서 수행
; https://www.sysnet.pe.kr/2/0/13487

닷넷: 2202. C# - PublishAot의 glibc에 대한 정적 링킹하는 방법
; https://www.sysnet.pe.kr/2/0/13529

오류 유형: 913. C# - AOT StaticExecutable 정적 링킹 시 빌드 오류
; https://www.sysnet.pe.kr/2/0/13669




C# - 하나의 resource 파일을 여러 프로그램에서 (AOT 시에도) 사용하는 방법

닷넷 응용 프로그램에는, 비주얼 스튜디오의 경우 간편하게 "resx" 파일을 통해 다양한 유형의 리소스를 임베딩해서 관리할 수 있습니다.

예를 들어 볼까요? ^^ 간단하게 콘솔 프로그램을 하나 만들고 "Resources File" 유형의 파일을 하나 추가합니다. 기본 이름인 경우 "Resource1.resx" 파일이 추가되는데요, 해당 파일을 비주얼 스튜디오에서 열어 "Add Resource"를 이용해 "test_file.zip" 압축 파일을 추가해 봅니다.

자, 그럼 당연히 해당 ConsoleApp1에서는 Assembly를 이용해 스스로의 리소스에 접근하는 것이 가능합니다.

using System.Reflection;
using System.Resources;

namespace ConsoleApp2;

internal class Program
{
    static void Main(string[] args)
    {
        Assembly asm = Assembly.GetExecutingAssembly();
        string resName = asm.GetName().Name + ".Resource1";
        ResourceManager rm = new ResourceManager(resName, asm);
        Console.WriteLine(rm); // 출력 결과: System.Resources.ResourceManager

        var result = rm.GetObject("test_file") as byte[];
        Console.WriteLine(result.Length); // 출력 결과: 175
    }
}

이제 추가로 ConsoleApp2 프로젝트를 하나 만들고, 위의 ConsoleApp1에 포함된 리소스를 접근하고 싶다면 이번에도 Assembly.LoadFile 등의 명령어를 이용해 Assembly 인스턴스를 만들어 접근하는 것이 가능합니다.

string currentDirectory = System.AppContext.BaseDirectory.TrimEnd(Path.PathSeparator);
string filePath = Path.Combine(currentDirectory, "ConsoleApp1.dll");
Assembly asm = Assembly.LoadFile(filePath);

string resName = "ConsoleApp1.Resource1";
ResourceManager rm = new ResourceManager(resName, asm);
Console.WriteLine(rm);

var result = rm.GetObject("test_file") as byte[];
Console.WriteLine(result.Length);

별로 어렵지 않죠? ^^




그런데 AOT 빌드를 생각하면 어떨까요? 이 경우, Assembly.LoadFile은 AOT 빌드 시 경고가 발생하고,

warning IL2026: Using member 'System.Reflection.Assembly.LoadFile(String)' which has 'RequiresUnreferencedCodeAttribute' can break functionality when trimming application code. Types and members the loaded assembly depends on might be removed


실행 시 다음과 같은 예외가 발생합니다.

Unhandled Exception: System.PlatformNotSupportedException: Operation is not supported on this platform.
   at Internal.Reflection.Execution.AssemblyBinderImplementation.Bind(String, AssemblyBindResult&, Exception&) + 0x34
   at System.Reflection.Runtime.Assemblies.RuntimeAssemblyInfo.GetRuntimeAssemblyFromPath(String) + 0x4c
   at System.Runtime.Loader.AssemblyLoadContext.LoadFromAssemblyPath(String) + 0x6d
   at System.Reflection.Assembly.LoadFile(String) + 0x12c
   at ConsoleApp2.Program.Main(String[] args) + 0x45
   at ConsoleApp2!<BaseAddress>+0x14ccc0

Load, LoadFrom, ReflectionOnlyLoad, UnsafeLoadFrom의 모든 메서드들이 저 오류가 발생하는데, 그러니까, 일단 동적으로 어셈블리를 로드하는 것은 AOT 환경일 경우 포기해야 합니다.




다행히도, 관점을 바꿔보면 우회 해결할 수 있는 여지가 있습니다.

위의 상황에서 개발자가 원하는 것은, (내부에 구현된 타입이 아닌) 해당 어셈블리의 리소스입니다. 따라서, 어셈블리 내에 임베딩시키지 말고 별도의 "리소스 DLL"로 분리하는 것입니다.

Create resource files for .NET apps
; https://learn.microsoft.com/en-us/dotnet/core/extensions/create-resource-files

방법은 매우 쉽습니다. 이미 ConsoleApp1 프로젝트에 resx 확장자로 포함한 파일(예: Resource1.resx)을 resgen.exe를 이용해서 빌드만 다시 해주면 됩니다.

c:\temp\ConsoleApp1\ConsoleApp1> resgen Resource1.resx
Read in 1 resources from "Resource1.resx"
Writing resource file...  Done.

// 1) msbuild 과정 중에 진행이 되도록 csproj에 Task로 지정할 수 있습니다.

// 2) resx 파일이 있으면 결국 프로젝트에 임베딩되기 때문에
// 별도의 Remove 설정을 해야 2중으로 리소스가 들어가는 것을 방지할 수 있습니다.

그럼, Resource1.resources 파일이 생성되는데요, 별도로 분리된 이 파일을 ConsoleApp1.exe와 ConsoleApp2.exe 모두에 함께 배포하면 됩니다. 그리고 이렇게 분리된 리소스를 ResourceManager.CreateFileBasedResourceManager 메서드를 이용해 다음과 같이 사용할 수 있습니다.

string currentDirectory = System.AppContext.BaseDirectory.TrimEnd(Path.PathSeparator);

ResourceManager rm = ResourceManager.CreateFileBasedResourceManager("Resource1", currentDirectory, null);
Console.WriteLine($"{rm}");
var zipFile = rm.GetObject("test_file", CultureInfo.InvariantCulture) as byte[];
Console.WriteLine($"{zipFile?.Length}");

위의 코드는 ConsoleApp1, ConsoleApp2 모두에서 잘 동작합니다. 따라서 임베딩하지 않은 리소스, 즉 외부 파일로 분리된 리소스를 Assembly.Load 대신 가져올 수 있어 AOT 빌드에서도 무난하게 사용할 수 있습니다. ^^

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




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







[최초 등록일: ]
[최종 수정일: 12/14/2023]

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)
13836정성태12/3/20246834디버깅 기술: 203. Windbg - x64 가상 주소를 물리 주소로 변환 (페이지 크기가 2MB인 경우)
13835정성태12/2/20249401오류 유형: 934. Azure - rm: cannot remove '...': Directory not empty
13834정성태11/29/20249337Windows: 275. C# - CUI 애플리케이션과 Console 윈도우 (Windows 10 미만의 Classic Console 모드인 경우) [1]파일 다운로드1
13833정성태11/29/20248354개발 환경 구성: 737. Azure Web App에서 Scale-out으로 늘어난 리눅스 인스턴스에 SSH 접속하는 방법
13832정성태11/27/20247800Windows: 274. Windows 7부터 도입한 conhost.exe
13831정성태11/27/20246881Linux: 111. eBPF - BPF_MAP_TYPE_PERF_EVENT_ARRAY, BPF_MAP_TYPE_RINGBUF에 대한 다양한 용어들
13830정성태11/25/20249470개발 환경 구성: 736. 파이썬 웹 앱을 Azure App Service에 배포하기
13829정성태11/25/20249522스크립트: 67. 파이썬 - Windows 버전에서 함께 설치되는 py.exe
13828정성태11/25/20247274개발 환경 구성: 735. Azure - 압축 파일을 이용한 web app 배포 시 디렉터리 구분이 안 되는 문제파일 다운로드1
13827정성태11/25/20248330Windows: 273. Windows 환경의 파일 압축 방법 (tar, Compress-Archive)
13826정성태11/21/20248716닷넷: 2313. C# - (비밀번호 등의) Console로부터 입력받을 때 문자열 출력 숨기기(echo 끄기)파일 다운로드1
13825정성태11/21/202410039Linux: 110. eBPF / bpf2go - BPF_RINGBUF_OUTPUT / BPF_MAP_TYPE_RINGBUF 사용법
13824정성태11/20/20247289Linux: 109. eBPF / bpf2go - BPF_PERF_OUTPUT / BPF_MAP_TYPE_PERF_EVENT_ARRAY 사용법
13823정성태11/20/20249294개발 환경 구성: 734. Ubuntu에 docker, kubernetes (k3s) 설치
13822정성태11/20/20249165개발 환경 구성: 733. Windbg - VirtualBox VM의 커널 디버거 연결 시 COM 포트가 없는 경우
13821정성태11/18/20248473Linux: 108. Linux와 Windows의 프로세스/스레드 ID 관리 방식
13820정성태11/18/20249311VS.NET IDE: 195. Visual C++ - C# 프로젝트처럼 CopyToOutputDirectory 항목을 추가하는 방법
13819정성태11/15/20246763Linux: 107. eBPF - libbpf CO-RE의 CONFIG_DEBUG_INFO_BTF 빌드 여부에 대한 의존성
13818정성태11/15/202410665Windows: 272. Windows 11 24H2 - sudo 추가 [1]
13817정성태11/14/20248024Linux: 106. eBPF / bpf2go - (BPF_MAP_TYPE_HASH) Map을 이용한 전역 변수 구현
13816정성태11/14/20249484닷넷: 2312. C#, C++ - Windows / Linux 환경의 Thread Name 설정파일 다운로드1
13815정성태11/13/20247180Linux: 105. eBPF - bpf2go에서 전역 변수 설정 방법
13814정성태11/13/20248044닷넷: 2311. C# - Windows / Linux 환경에서 Native Thread ID 가져오기파일 다운로드1
13813정성태11/12/20249693닷넷: 2310. .NET의 Rune 타입과 emoji 표현파일 다운로드1
13812정성태11/11/202413156오류 유형: 933. Active Directory - The forest functional level is not supported.
13811정성태11/11/20247793Linux: 104. Linux - COLUMNS 환경변수가 언제나 80으로 설정되는 환경
1  2  3  4  5  6  7  [8]  9  10  11  12  13  14  15  ...