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)
13098정성태7/13/20226469개발 환경 구성: 647. Azure - scale-out 상태의 App Service에서 특정 인스턴스에 요청을 보내는 방법 [1]
13097정성태7/12/20225827오류 유형: 817. Golang - binary.Read: invalid type int32
13096정성태7/8/20228723.NET Framework: 2030. C# 11 - UTF-8 문자열 리터럴
13095정성태7/7/20226794Windows: 208. AD 도메인에 참여하지 않은 컴퓨터에서 Kerberos 인증을 사용하는 방법
13094정성태7/6/20226566오류 유형: 816. Golang - "short write" 오류 원인
13093정성태7/5/20227421.NET Framework: 2029. C# - HttpWebRequest로 localhost 접속 시 2초 이상 지연
13092정성태7/3/20228368.NET Framework: 2028. C# - HttpWebRequest의 POST 동작 방식파일 다운로드1
13091정성태7/3/20227313.NET Framework: 2027. C# - IPv4, IPv6를 모두 지원하는 서버 소켓 생성 방법
13090정성태6/29/20226357오류 유형: 815. PyPI에 업로드한 패키지가 반영이 안 되는 경우
13089정성태6/28/20226831개발 환경 구성: 646. HOSTS 파일 변경 시 Edge 브라우저에 반영하는 방법
13088정성태6/27/20225794개발 환경 구성: 645. "Developer Command Prompt for VS 2022" 명령행 환경의 폰트를 바꾸는 방법
13087정성태6/23/20228849스크립트: 41. 파이썬 - FastAPI / uvicorn 호스팅 환경에서 asyncio 사용하는 방법 [1]
13086정성태6/22/20228297.NET Framework: 2026. C# 11 - 문자열 보간 개선 2가지파일 다운로드1
13085정성태6/22/20228392.NET Framework: 2025. C# 11 - 원시 문자열 리터럴(raw string literals)파일 다운로드1
13084정성태6/21/20226817개발 환경 구성: 644. Windows - 파이썬 2.7을 msi 설치 없이 구성하는 방법
13083정성태6/20/20227446.NET Framework: 2024. .NET 7에 도입된 GC의 메모리 해제에 대한 segment와 region의 차이점 [2]
13082정성태6/19/20226507.NET Framework: 2023. C# - Process의 I/O 사용량을 보여주는 GetProcessIoCounters Win32 API파일 다운로드1
13081정성태6/17/20226536.NET Framework: 2022. C# - .NET 7 Preview 5 신규 기능 - System.IO.Stream ReadExactly / ReadAtLeast파일 다운로드1
13080정성태6/17/20227217개발 환경 구성: 643. Visual Studio 2022 17.2 버전에서 C# 11 또는 .NET 7.0 preview 적용
13079정성태6/17/20224834오류 유형: 814. 파이썬 - Error: The file/path provided (...) does not appear to exist
13078정성태6/16/20227021.NET Framework: 2021. WPF - UI Thread와 Render Thread파일 다운로드1
13077정성태6/15/20227228스크립트: 40. 파이썬 - PostgreSQL 환경 구성
13075정성태6/15/20226204Linux: 50. Linux - apt와 apt-get의 차이 [2]
13074정성태6/13/20226528.NET Framework: 2020. C# - NTFS 파일에 사용자 정의 속성값 추가하는 방법파일 다운로드1
13073정성태6/12/20226808Windows: 207. Windows Server 2022에 도입된 WSL 2
13072정성태6/10/20227093Linux: 49. Linux - ls 명령어로 출력되는 디렉터리 색상 변경 방법
... 16  17  18  19  20  21  [22]  23  24  25  26  27  28  29  30  ...