AssemblyVersion, AssemblyFileVersion, AssemblyInformationalVersion
제목에서와 같이 닷넷에서는 버전에 대한 다양한 "특성"들을 제공해 주고 있습니다. 사용법은 모두 assembly 수준에서 다음과 같이 지정이 됩니다. (대개, AssemblyInfo.cs에서 지정하죠.)
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]
[assembly: AssemblyInformationalVersion("1.0.0.0")]
그렇다면... 어떤 차이가 있을까요?
- AssemblyVersion은 말 그대로 Assembly의 버전입니다. GAC에 등록될 때 사용되는 버전이 바로 이것입니다.
- AssemblyFileVersion은 Win32 VERSIONINFO 리소스의 "FILEVERSION"과 같습니다.
- AssemblyInformationalVersion은 Win32 VERSIONINFO 리소스의 "PRODUCTVERSION"과 같습니다.
탐색기를 이용하면 AssemblyFileVersion과 AssemblyInformationalVersion을 아래와 같이 확인할 수 있습니다.
정리해 보면, 닷넷에서는 단지 기존 Win32와 비교해서 AssemblyVersion이 새롭게 추가된 것에 불과합니다.
버전 관리 정책이야, CLR 차원에서 어떤 강제성을 띄는 것이 없기 때문에 유연하게 가져갈 수 있습니다. 참고로, 저 같은 경우에는 위의 3가지 버전을 모두 이용하는데요. 기준은 다음과 같습니다.
AssemblyVersion
하위 호환성이 깨지는 등의 큰 문제가 발생하지 않는다면 이 버전은 가능한 바꾸지 않습니다. 왜냐하면, GAC에 등록되어 관리되기 때문에 버전 업을 수시로 하는 경우 버전 관련 문제가 심각하게 발생할 수 있기 때문입니다. 실례로, 마이크로소프트도 .NET Framework에 대한 패치를 내놓긴 하지만 GAC에 등록될 AssemblyVersion을 바꾸는 사례는 없었지요. (2024-06-21 업데이트) GAC가 없어진 .NET Core/5+에 접어들면서 AssemblyFileVersion과 동일하게 버전을 바꾸는 것이 권장됩니다.
AssemblyFileVersion
해당 어셈블리의 코드가 실제로 변경되었을 때만 증가를 시킵니다. CLR은 AssemblyFileVersion을 전혀 사용하지 않기 때문에 개발자 임의로 관리하는 것이 가능합니다.
때로는 이 버전 번호를 올리는 것을 잊곤 하는데, 그것이 큰 문제는 되지 않습니다. 만약 중/대형 SI 프로젝트라면 AssemblyFileVersion은 그냥 무시하는 것이 좋을 수도 있습니다.
(아니면 자동 증가할 수 있도록 '*' 를 사용)
이 버전의 관리 이유는, 단지 해당 어셈블리가 얼마나 변경이 되었는가를 아는 정도이거나, 제품 배포 시에 특정 파일만 변경되어서 나가는 패치 등이 있을 때 정도에만 의미가 있는 수준입니다.
AssemblyInformationalVersion
이 버전 번호를 이용해서 전체 제품의 버전 번호를 동일하게 관리할 수 있도록 합니다. 배포될 때마다 이 버전 번호가 증가하도록 하고, TFS의 Label이 적용됩니다.
편의상, AssemblyInformationalVersion은 별도의 공통 파일(예를 들어, GlobalAssemblyInfo.cs)로 만들어 두고 모든 프로젝트에서 "Add as link" 기능으로 추가해 놓는 것이 권장됩니다. 해당 cs 파일에는 아래와 같은 정도만 포함해 두고 배포될 때마다 버전 번호를 올려주기 때문에 모든 어셈블리의 버전 번호가 이에 맞춰지게 됩니다.
using System.Reflection;
using System.Runtime.CompilerServices;
[assembly: AssemblyCompany("....")] // 기왕이면 Company 설정도 꼭 하는 걸 권장합니다.
// The documentation says that CompanyName version information is required, but my program seems to work without it, so how required is it?
// https://devblogs.microsoft.com/oldnewthing/20250910-00/?p=111582
[assembly: AssemblyProduct("...")]
[assembly: AssemblyCopyright("...")]
[assembly: AssemblyInformationalVersion("1.0.0.0")]
위의 언급된 내용은, 제 기준이고,,, ^^ 혹시, 자신만의 버전 관리 정책에 대한 노하우가 있으시다면 공유해 보시는 것도 좋겠지요.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]