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분
맞춰보세요... 같은 사람일까요? ^^
정성태

1  2  3  4  5  6  7  8  9  10  11  12  13  [14]  15  ...
NoWriterDateCnt.TitleFile(s)
13283정성태3/12/20233644오류 유형: 852. 파이썬 - TypeError: coercing to Unicode: need string or buffer, NoneType found
13282정성태3/12/20233969Linux: 58. WSL - nohup 옵션이 필요한 경우
13281정성태3/12/20233924Windows: 225. 윈도우 바탕화면의 아이콘들이 넓게 퍼지는 경우 [2]
13280정성태3/9/20234698개발 환경 구성: 670. WSL 2에서 호스팅 중인 TCP 서버를 외부에서 접근하는 방법
13279정성태3/9/20234213오류 유형: 851. 파이썬 ModuleNotFoundError: No module named '_cffi_backend'
13278정성태3/8/20234192개발 환경 구성: 669. WSL 2의 (init이 아닌) systemd 지원 [1]
13277정성태3/6/20234828개발 환경 구성: 668. 코드 사인용 인증서 신청 및 적용 방법(예: Digicert)
13276정성태3/5/20234508.NET Framework: 2102. C# 11 - ref struct/ref field를 위해 새롭게 도입된 scoped 예약어
13275정성태3/3/20234818.NET Framework: 2101. C# 11의 ref 필드 설명
13274정성태3/2/20234367.NET Framework: 2100. C# - ref 필드로 ref struct 타입을 허용하지 않는 이유
13273정성태2/28/20234130.NET Framework: 2099. C# - 관리 포인터로서의 ref 예약어 의미
13272정성태2/27/20234369오류 유형: 850. SSMS - mdf 파일을 Attach 시킬 때 Operating system error 5: "5(Access is denied.)" 에러
13271정성태2/25/20234334오류 유형: 849. Sql Server Configuration Manager가 시작 메뉴에 없는 경우
13270정성태2/24/20233897.NET Framework: 2098. dotnet build에 /p 옵션을 적용 시 유의점
13269정성태2/23/20234508스크립트: 46. 파이썬 - uvicorn의 콘솔 출력을 UDP로 전송
13268정성태2/22/20235043개발 환경 구성: 667. WSL 2 내부에서 열고 있는 UDP 서버를 호스트 측에서 접속하는 방법
13267정성태2/21/20234943.NET Framework: 2097. C# - 비동기 소켓 사용 시 메모리 해제가 finalizer 단계에서 발생하는 사례파일 다운로드1
13266정성태2/20/20234571오류 유형: 848. .NET Core/5+ - Process terminated. Couldn't find a valid ICU package installed on the system
13265정성태2/18/20234485.NET Framework: 2096. .NET Core/5+ - PublishSingleFile 유형에 대한 runtimeconfig.json 설정
13264정성태2/17/20236023스크립트: 45. 파이썬 - uvicorn 사용자 정의 Logger 작성
13263정성태2/16/20234167개발 환경 구성: 666. 최신 버전의 ilasm.exe/ildasm.exe 사용하는 방법
13262정성태2/15/20235223디버깅 기술: 191. dnSpy를 이용한 (소스 코드가 없는) 닷넷 응용 프로그램 디버깅 방법 [1]
13261정성태2/15/20234506Windows: 224. Visual Studio - 영문 폰트가 Fullwidth Latin Character로 바뀌는 문제
13260정성태2/14/20234310오류 유형: 847. ilasm.exe 컴파일 오류 - error : syntax error at token '-' in ... -inf
13259정성태2/14/20234468.NET Framework: 2095. C# - .NET5부터 도입된 CollectionsMarshal
13258정성태2/13/20234313오류 유형: 846. .NET Framework 4.8 Developer Pack 설치 실패 - 0x81f40001
1  2  3  4  5  6  7  8  9  10  11  12  13  [14]  15  ...