Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

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을 아래와 같이 확인할 수 있습니다.

assembly_version_in_dotnet_1_techshare.png

정리해 보면, 닷넷에서는 단지 기존 Win32와 비교해서 AssemblyVersion이 새롭게 추가된 것에 불과합니다.




버전 관리 정책이야, CLR 차원에서 어떤 강제성을 띄는 것이 없기 때문에 유연하게 가져갈 수 있습니다. 참고로, 저 같은 경우에는 위의 3가지 버전을 모두 이용하는데요. 기준은 다음과 같습니다.


AssemblyVersion

하위 호환성이 깨지는 등의 큰 문제가 발생하지 않는다면 이 버전은 가능한 바꾸지 않습니다. 왜냐하면, GAC에 등록되어 관리되기 때문에 버전업을 수시로 하는 경우 버전관련 문제가 심각하게 발생할 수 있기 때문입니다. 실례로, 마이크로소프트도 .NET Framework에 대한 패치를 내놓긴 하지만 GAC에 등록될 AssemblyVersion을 바꾸는 사례는 없었지요.


AssemblyFileVersion

해당 어셈블리의 코드가 실제로 변경되었을 때만 증가를 시킵니다. CLR은 AssemblyFileVersion을 전혀 사용하지 않기 때문에 개발자 임의로 관리하는 것이 가능합니다.

때로는 이 버전번호를 올리는 것을 잊곤 하는데, 그것이 큰 문제는 되지 않습니다. 만약 중/대형 SI 프로젝트라면 AssemblyFileVersion은 그냥 무시하는 것이 좋을 수도 있습니다. (아니면 자동 증가할 수 있도록 '*' 를 사용)
이 버전의 관리 이유는, 단지 해당 어셈블리가 얼마나 변경이 되었는 가를 아는 정도이거나, 제품 배포시에 특정 파일만 변경되어서 나가는 패치등이 있을 때 정도에만 의미가 있는 수준입니다.


AssemblyInformationalVersion

이 버전 번호를 이용해서 전체 제품의 버전 번호를 동일하게 관리할 수 있도록 합니다. 배포될 때 마다 이 버전 번호가 증가하도록 하고, TFS의 Label이 적용됩니다.

편의상, AssemblyInformationalVersion은 별도의 공통 파일(예를 들어, GlobalAssemblyInfo.cs)로 만들어 두고 모든 프로젝트에서 "Add as link" 기능으로 추가해 놓는 것이 권장됩니다. 해당 cs 파일에는 아래와 같은 정도만 포함해 두고 배포될 때마다 버전 번호를 올려주기 때문에 모든 어셈블리의 버전 번호가 이에 맞춰지게 됩니다.

using System.Reflection;
using System.Runtime.CompilerServices;

[assembly: AssemblyCompany("....")]
[assembly: AssemblyProduct("...")]
[assembly: AssemblyCopyright("...")]

[assembly: AssemblyInformationalVersion("1.0.0.0")]

위의 언급된 내용은, 제 기준이고,,, ^^ 혹시, 자신만의 버전 관리 정책에 대한 노하우가 있으시다면 공유해 보시는 것도 좋겠지요.




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

[연관 글]






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

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

비밀번호

댓글 작성자
 



2010-07-26 07시42분
[땡초] 참으로 버전은 관리하기가 힘든 것 같아요.
제 노하우는 아니지만, 어떤 곳에서는 Published 한 날짜를 버전으로 사용하는군요.
가령, 2010.07.26.01
나름 나쁘지는 않은 것 같아요. ㅎㅎ;;
[guest]
2010-07-26 10시18분
그렇군요. ^^ 날짜라... 충분히 고려할 법 한데요. 편할 것 같습니다. ^^
보통 Label에 날짜가 할당되기 때문에 버전명에 같이 기록이 되면 찾아보기도 좋겠고. ^^
kevin25
2011-07-15 02시27분
[손님2] AssemblyFileVersion은 '*'이 안먹는거 같네요.
[guest]
2011-07-18 10시55분
"[손님2]"님 의견이 맞습니다. (내용 수정했습니다. ^^)
정성태
2015-06-18 04시34분
[guest]
2015-06-18 04시35분
[가이세르네] 아. 아이디 확인 버튼이 아니라 글 쓰는 확인버튼이군요. -_-;
저 위의 링크랑 같은 분이신가? 해서 물어보려했는데, 글이 이상하게 올라갔습니다. ^^;
[guest]
2015-06-18 04시56분
맞춰보세요... 같은 사람일까요? ^^
정성태

... 16  17  18  [19]  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
13171정성태11/25/20225058Windows: 214. 윈도우 - 스레드 스택의 "red zone"
13170정성태11/24/20225335Windows: 213. 윈도우 - 싱글 스레드는 컨텍스트 스위칭이 없을까요?
13169정성태11/23/20225906Windows: 212. 윈도우의 Protected Process (Light) 보안 [1]파일 다운로드2
13168정성태11/22/20225255제니퍼 .NET: 31. 제니퍼 닷넷 적용 사례 (9) - DB 서비스에 부하가 걸렸다?!
13167정성태11/21/20225276.NET Framework: 2070. .NET 7 - Console.ReadKey와 리눅스의 터미널 타입
13166정성태11/20/20224998개발 환경 구성: 651. Windows 사용자 경험으로 WSL 환경에 dotnet 런타임/SDK 설치 방법
13165정성태11/18/20224882개발 환경 구성: 650. Azure - "scm" 프로세스와 엮인 서비스 모음
13164정성태11/18/20225828개발 환경 구성: 649. Azure - 비주얼 스튜디오를 이용한 AppService 원격 디버그 방법
13163정성태11/17/20225736개발 환경 구성: 648. 비주얼 스튜디오에서 안드로이드 기기 인식하는 방법
13162정성태11/15/20226788.NET Framework: 2069. .NET 7 - AOT(ahead-of-time) 컴파일
13161정성태11/14/20226072.NET Framework: 2068. C# - PublishSingleFile로 배포한 이미지의 역어셈블 가능 여부 (난독화 필요성) [4]
13160정성태11/11/20225990.NET Framework: 2067. C# - PublishSingleFile 적용 시 native/managed 모듈 통합 옵션
13159정성태11/10/20229279.NET Framework: 2066. C# - PublishSingleFile과 관련된 옵션 [3]
13158정성태11/9/20225439오류 유형: 826. Workload definition 'wasm-tools' in manifest 'microsoft.net.workload.mono.toolchain' [...] conflicts with manifest 'microsoft.net.workload.mono.toolchain.net7'
13157정성태11/8/20226081.NET Framework: 2065. C# - Mutex의 비동기 버전파일 다운로드1
13156정성태11/7/20227020.NET Framework: 2064. C# - Mutex와 Semaphore/SemaphoreSlim 차이점파일 다운로드1
13155정성태11/4/20226477디버깅 기술: 183. TCP 동시 접속 (연결이 아닌) 시도를 1개로 제한한 서버
13154정성태11/3/20225960.NET Framework: 2063. .NET 5+부터 지원되는 GC.GetGCMemoryInfo파일 다운로드1
13153정성태11/2/20227268.NET Framework: 2062. C# - 코드로 재현하는 소켓 상태(SYN_SENT, SYN_RECV)
13152정성태11/1/20225849.NET Framework: 2061. ASP.NET Core - DI로 추가한 클래스의 초기화 방법 [1]
13151정성태10/31/20226026C/C++: 161. Windows 11 환경에서 raw socket 테스트하는 방법파일 다운로드1
13150정성태10/30/20225990C/C++: 160. Visual Studio 2022로 빌드한 C++ 프로그램을 위한 다른 PC에서 실행하는 방법
13149정성태10/27/20225959오류 유형: 825. C# - CLR ETW 이벤트 수신이 GCHeapStats_V1/V2에 대해 안 되는 문제파일 다운로드1
13148정성태10/26/20225901오류 유형: 824. msbuild 에러 - error NETSDK1005: Assets file '...\project.assets.json' doesn't have a target for 'net5.0'. Ensure that restore has run and that you have included 'net5.0' in the TargetFramew
13147정성태10/25/20224973오류 유형: 823. Visual Studio 2022 - Unable to attach to CoreCLR. The debugger's protocol is incompatible with the debuggee.
13146정성태10/24/20225838.NET Framework: 2060. C# - Java의 Xmx와 유사한 힙 메모리 최댓값 제어 옵션 HeapHardLimit
... 16  17  18  [19]  20  21  22  23  24  25  26  27  28  29  30  ...