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)
13197정성태12/17/20224574.NET Framework: 2079. .NET Core/5+ 환경에서 XmlSerializer 사용 시 System.IO.FileNotFoundException 예외 발생하는 경우파일 다운로드1
13196정성태12/16/20224790.NET Framework: 2078. .NET Core/5+를 위한 SGen(Microsoft.XmlSerializer.Generator) 사용법
13195정성태12/15/20225255개발 환경 구성: 655. docker - bridge 네트워크 모드에서 컨테이너 간 통신 시 --link 옵션 권장 이유
13194정성태12/14/20225349오류 유형: 833. warning C4747: Calling managed 'DllMain': Managed code may not be run under loader lock파일 다운로드1
13193정성태12/14/20225466오류 유형: 832. error C7681: two-phase name lookup is not supported for C++/CLI or C++/CX; use /Zc:twoPhase-
13192정성태12/13/20225532Linux: 55. 리눅스 - bash shell에서 실수 연산
13191정성태12/11/20226440.NET Framework: 2077. C# - 직접 만들어 보는 SynchronizationContext파일 다운로드1
13190정성태12/9/20226932.NET Framework: 2076. C# - SynchronizationContext 기본 사용법파일 다운로드1
13189정성태12/9/20227785오류 유형: 831. Visual Studio - Windows Forms 디자이너의 도구 상자에 컨트롤이 보이지 않는 문제
13188정성태12/9/20226363.NET Framework: 2075. C# - 직접 만들어 보는 TaskScheduler 실습 (SingleThreadTaskScheduler)파일 다운로드1
13187정성태12/8/20226295개발 환경 구성: 654. openssl - CA로부터 인증받은 새로운 인증서를 생성하는 방법 (2)
13186정성태12/6/20224855오류 유형: 831. The framework 'Microsoft.AspNetCore.App', version '...' was not found.
13185정성태12/6/20225814개발 환경 구성: 653. Windows 환경에서의 Hello World x64 어셈블리 예제 (NASM 버전)
13184정성태12/5/20225008개발 환경 구성: 652. ml64.exe와 link.exe x64 실행 환경 구성
13183정성태12/4/20225010오류 유형: 830. MASM + CRT 함수를 사용하는 경우 발생하는 컴파일 오류 정리
13182정성태12/4/20225755Windows: 217. Windows 환경에서의 Hello World x64 어셈블리 예제 (MASM 버전)
13181정성태12/3/20225137Linux: 54. 리눅스/WSL - hello world 어셈블리 코드 x86/x64 (nasm)
13180정성태12/2/20225210.NET Framework: 2074. C# - 스택 메모리에 대한 여유 공간 확인하는 방법파일 다운로드1
13179정성태12/2/20224538Windows: 216. Windows 11 - 22H2 업데이트 이후 Terminal 대신 cmd 창이 뜨는 경우
13178정성태12/1/20225080Windows: 215. Win32 API 금지된 함수 - IsBadXxxPtr 유의 함수들이 안전하지 않은 이유파일 다운로드1
13177정성태11/30/20225799오류 유형: 829. uwsgi 설치 시 fatal error: Python.h: No such file or directory
13176정성태11/29/20224637오류 유형: 828. gunicorn - ModuleNotFoundError: No module named 'flask'
13175정성태11/29/20226470오류 유형: 827. Python - ImportError: cannot import name 'html5lib' from 'pip._vendor'
13174정성태11/28/20224909.NET Framework: 2073. C# - VMMap처럼 스택 메모리의 reserve/guard/commit 상태 출력파일 다운로드1
13173정성태11/27/20225682.NET Framework: 2072. 닷넷 응용 프로그램의 스레드 스택 크기 변경
13172정성태11/25/20225396.NET Framework: 2071. 닷넷에서 ESP/RSP 레지스터 값을 구하는 방법파일 다운로드1
... 16  17  [18]  19  20  21  22  23  24  25  26  27  28  29  30  ...