.NET Core/5+를 위한 SGen(Microsoft.XmlSerializer.Generator) 사용법
예전에 설명한,
XmlSerializer 생성자의 실행 속도를 올리는 방법
; https://www.sysnet.pe.kr/2/0/511
XmlSerializer 생성자의 실행 속도를 올리는 방법 - 두 번째 이야기
; https://www.sysnet.pe.kr/2/0/521
sgen.exe의 사용법은 아쉽게도 .NET Core/5+ 대상의 어셈블리에는 통용되지 않습니다. 대신, 마이크로소프트는 이와 동등한 역할을 하는 Microsoft.XmlSerializer.Generator 패키지를 공개했는데요, 관련 문서에서도 이에 대해 자세하게 다루고 있습니다.
Using Microsoft XML Serializer Generator on .NET Core
; https://learn.microsoft.com/en-us/dotnet/core/additional-tools/xml-serializer-generator
간단하게 실습해 볼까요? ^^
.NET Core/5+ 라이브러리 프로젝트를 하나 생성하고 예제를 위한 클래스 하나를 정의해 둡니다.
public class Dummy
{
public int Value { get; set; }
}
그다음, 해당 프로젝트에 nuget으로부터 Microsoft.XmlSerializer.Generator 패키지를 참조 추가합니다.
Install-Package Microsoft.XmlSerializer.Generator
끝입니다. ^^ 저걸 참조한 것만으로도 이제 빌드할 때마다 [어셈블리명].XmlSerializers.cs 파일이 자동 생성되고, 그것을 빌드한 [어셈블리명].XmlSerializers.dll 파일이 출력 폴더에 함께 생성됩니다.
Rebuild started...
1>------ Rebuild All started: Project: ClassLibrary1, Configuration: Debug Any CPU ------
Restored C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj (in 1 ms).
Restored C:\temp\ConsoleApp1\ClassLibrary3\ClassLibrary3.csproj (in 1 ms).
Restored C:\temp\ConsoleApp1\ClassLibrary1\ClassLibrary1.csproj (in 2 ms).
Restored C:\temp\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj (in 1 ms).
1>ClassLibrary1 -> C:\temp\ConsoleApp1\ClassLibrary1\bin\Debug\net5.0\ClassLibrary1.dll
1>.NET Xml Serialization Generation Utility, Version 7.0.0]
1>Serialization Code File Name: C:\temp\ConsoleApp1\ClassLibrary1\obj\Debug\net5.0\ClassLibrary1.XmlSerializers.cs.
1>Generated serialization code for assembly C:\temp\ConsoleApp1\ClassLibrary1\obj\Debug\net5.0\ClassLibrary1.dll --> 'C:\temp\ConsoleApp1\ClassLibrary1\obj\Debug\net5.0\ClassLibrary1.XmlSerializers.cs'.
========== Rebuild All: 1 succeeded, 0 failed, 0 skipped ==========
========== Elapsed 00:01.089 ==========
오히려, 예전 sgen 관리 때보다 더 편해졌다고도 볼 수 있습니다. ^^
참고로, .NET Framework 버전의 sgen을 이용해 .NET Core/5+ 어셈블리를 인자로 실행하면 이런 오류가 발생할 것입니다.
c:\temp> where sgen
C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\x64\sgen.exe
c:\temp> sgen Test.dll
Microsoft (R) Xml Serialization support utility
[Microsoft (R) .NET Framework, Version 4.8.3928.0]
Copyright (C) Microsoft Corporation. All rights reserved.
Error: Could not load file or assembly 'System.Runtime, Version=5.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. The system cannot find the file specified.
If you would like more help, please type "sgen /?".
또는, 해당 어셈블리로부터 아무런 타입도 찾을 수 없다는 메시지가 뜨기도 합니다.
c:\temp> sgen classlibrary3.dll
Microsoft (R) Xml Serialization support utility
[Microsoft (R) .NET Framework, Version 4.8.3928.0]
Copyright (C) Microsoft Corporation. All rights reserved.
Assembly 'C:\temp\ConsoleApp1\ClassLibrary3\bin\Debug\net7.0\classlibrary3.dll' does not contain any types that can be serialized using XmlSerializer. Please use /verbose switch for more information.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]