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

(시리즈 글이 6개 있습니다.)
개발 환경 구성: 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




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)
13528정성태1/14/20242033Linux: 68. busybox 컨테이너에서 실행 가능한 C++, Go 프로그램 빌드
13527정성태1/14/20241961오류 유형: 892. Visual Studio - Failed to launch debug adapter. Additional information may be available in the output window.
13526정성태1/14/20242051닷넷: 2201. C# - Facebook 연동 / 사용자 탈퇴 처리 방법
13525정성태1/13/20242021오류 유형: 891. Visual Studio - Web Application을 실행하지 못하는 IISExpress
13524정성태1/12/20242066오류 유형: 890. 한국투자증권 KIS Developers OpenAPI - GW라우팅 중 오류가 발생했습니다.
13523정성태1/12/20241889오류 유형: 889. Visual Studio - error : A project with that name is already opened in the solution.
13522정성태1/11/20242030닷넷: 2200. C# - HttpClient.PostAsJsonAsync 호출 시 "Transfer-Encoding: chunked" 대신 "Content-Length" 헤더 처리
13521정성태1/11/20242110닷넷: 2199. C# - 한국투자증권 KIS Developers OpenAPI의 WebSocket Ping, Pong 처리
13520정성태1/10/20241858오류 유형: 888. C# - Unable to resolve service for type 'Microsoft.Extensions.ObjectPool.ObjectPool`....'
13519정성태1/10/20241939닷넷: 2198. C# - Reflection을 이용한 ClientWebSocket의 Ping 호출파일 다운로드1
13518정성태1/9/20242175닷넷: 2197. C# - ClientWebSocket의 Ping, Pong 처리
13517정성태1/8/20242017스크립트: 63. Python - 공개 패키지를 이용한 위성 이미지 생성 (pystac_client, odc.stac)
13516정성태1/7/20242104닷넷: 2196. IIS - AppPool의 "Disable Overlapped Recycle" 옵션의 부작용
13515정성태1/6/20242377닷넷: 2195. async 메서드 내에서 C# 7의 discard 구문 활용 사례 [1]
13514정성태1/5/20242065개발 환경 구성: 702. IIS - AppPool의 "Disable Overlapped Recycle" 옵션
13513정성태1/5/20242006닷넷: 2194. C# - WebActivatorEx / System.Web의 PreApplicationStartMethod 특성
13512정성태1/4/20241979개발 환경 구성: 701. IIS - w3wp.exe 프로세스의 ASP.NET 런타임을 항상 Warmup 모드로 유지하는 preload Enabled 설정
13511정성태1/4/20241997닷넷: 2193. C# - ASP.NET Web Application + OpenAPI(Swashbuckle) 스펙 제공
13510정성태1/3/20241937닷넷: 2192. C# - 특정 실행 파일이 있는지 확인하는 방법 (Linux)
13509정성태1/3/20241966오류 유형: 887. .NET Core 2 이하의 프로젝트에서 System.Runtime.CompilerServices.Unsafe doesn't support netcoreapp2.0.
13508정성태1/3/20242016오류 유형: 886. ORA-28000: the account is locked
13507정성태1/2/20242702닷넷: 2191. C# - IPGlobalProperties를 이용해 netstat처럼 사용 중인 Socket 목록 구하는 방법파일 다운로드1
13506정성태12/29/20232191닷넷: 2190. C# - 닷넷 코어/5+에서 달라지는 System.Text.Encoding 지원
13505정성태12/27/20232707닷넷: 2189. C# - WebSocket 클라이언트를 닷넷으로 구현하는 예제 (System.Net.WebSockets)파일 다운로드1
13504정성태12/27/20232322닷넷: 2188. C# - ASP.NET Core SignalR로 구현하는 채팅 서비스 예제파일 다운로드1
13503정성태12/27/20232191Linux: 67. WSL 환경 + mlocate(locate) 도구의 /mnt 디렉터리 검색 문제
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...