여러 프로젝트가있는 솔루션이 있습니다. 솔루션 전체 어셈블리 정보 파일 하나를 연결하여 AssemblyInfo.cs 파일을 최적화하려고합니다. 이를위한 모범 사례는 무엇입니까? 솔루션 전체 파일에 어떤 속성이 있어야하며 프로젝트 / 어셈블리에 특정한 속성은 무엇입니까?
편집 : 관심이 있다면 후속 질문 이 있습니다. AssemblyVersion, AssemblyFileVersion 및 AssemblyInformationalVersion의 차이점은 무엇입니까?
답변:
GlobalAssemblyInfo.cs라는 전역 파일과 AssemblyInfo.cs라는 로컬 파일을 사용하고 있습니다. 글로벌 파일에는 다음과 같은 속성이 있습니다.
[assembly: AssemblyProduct("Your Product Name")]
[assembly: AssemblyCompany("Your Company")]
[assembly: AssemblyCopyright("Copyright © 2008 ...")]
[assembly: AssemblyTrademark("Your Trademark - if applicable")]
#if DEBUG
[assembly: AssemblyConfiguration("Debug")]
#else
[assembly: AssemblyConfiguration("Release")]
#endif
[assembly: AssemblyVersion("This is set by build process")]
[assembly: AssemblyFileVersion("This is set by build process")]로컬 AssemblyInfo.cs에는 다음 속성이 포함되어 있습니다.
[assembly: AssemblyTitle("Your assembly title")]
[assembly: AssemblyDescription("Your assembly description")]
[assembly: AssemblyCulture("The culture - if not neutral")]
[assembly: ComVisible(true/false)]
// unique id per assembly
[assembly: Guid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")]다음 절차를 사용하여 GlobalAssemblyInfo.cs를 추가 할 수 있습니다.
AssemblyCultureAttribute더 나은 설명 이 필요합니다. 이 속성은 위성 어셈블리가 아닌 경우에는 완전히 없어야합니다. 위성 어셈블리를 대규모로 사용하는 경우 두 가지 수준의 어셈블리 정보 파일 (이 경우 문화 만 지정하는 글로벌, 기본 어셈블리 및 위성 어셈블리)이 아닌 3 개 레벨이 필요할 수 있습니다.
필자의 경우 우리는 Visual Studio 솔루션을 보유한 제품을 자체 프로젝트의 다양한 구성 요소와 함께 구축하고 있습니다. 공통적 인 속성이 있습니다. 이 솔루션에는 약 35 개의 프로젝트와 다음과 같은 특성을 가진 공통 어셈블리 정보 (CommonAssemblyInfo.cs)가 있습니다.
[assembly: AssemblyCompany("Company")]
[assembly: AssemblyProduct("Product Name")]
[assembly: AssemblyCopyright("Copyright © 2007 Company")]
[assembly: AssemblyTrademark("Company")]
//This shows up as Product Version in Windows Explorer
//We make this the same for all files in a particular product version. And increment it globally for all projects.
//We then use this as the Product Version in installers as well (for example built using Wix).
[assembly: AssemblyInformationalVersion("0.9.2.0")]AssemblyTitle, AssemblyVersion 등과 같은 다른 속성은 어셈블리별로 제공합니다. 어셈블리를 빌드 할 때 AssemblyInfo.cs와 CommonAssemblyInfo.cs가 각 어셈블리에 내장되어 있습니다. 이를 통해 모든 프로젝트에 공통적 인 속성을 부여하고 일부는 다른 가치를 부여 할 수 있습니다.
희망이 도움이됩니다.
<Compile Include="$(MSBuildThisFileDirectory)..\Common\CommonAssemblyInfo.cs"/>공유 Common.targets파일 에있을 수있는 MSBuild 지시문 인 각 .csproj through에 포함되어 있다고 가정 합니다. 예 코드 재사용.
@JRoppert가 제시 한 솔루션은 내가하는 것과 거의 동일합니다. 유일한 차이점은 로컬 AssemblyInfo.cs 파일에 다음과 같은 줄을 넣는 것입니다. 각 어셈블리마다 다를 수 있습니다.
#if DEBUG
[assembly: AssemblyConfiguration("Debug")]
#else
[assembly: AssemblyConfiguration("Release")]
#endif
[assembly: AssemblyVersion("This is set by build process")]
[assembly: AssemblyFileVersion("This is set by build process")]
[assembly: CLSCompliant(true)]또한 하나의 솔루션이 단일 제품 라인 / 릴리스 가능한 제품이라는 가정하에 솔루션 당 하나의 공통 어셈블리 정보를 (일반적으로) 사용합니다. 공통 어셈블리 정보 파일에는 다음이 포함됩니다.
[assembly: AssemblyInformationalVersion("0.9.2.0")]Windows 탐색기에 표시되는 "ProductVersion"값을 설정합니다.
MSBuild 커뮤니티 작업 에는 assemblyinfo.cs를 생성하는 데 사용할 수있는 AssemblyInfo라는 사용자 지정 작업이 포함되어 있습니다. 사용하려면 csproj 파일을 약간 수동으로 편집해야하지만 가치가 있습니다.
내 의견으로는 GlobalAssemblyInfo.cs를 사용하는 것이 가치가있는 것보다 더 문제가됩니다. 모든 프로젝트 파일을 수정하고 모든 새 프로젝트를 수정 해야하는 반면 기본적으로 AssemblyInfo.cs를 가져 오기 때문입니다.
글로벌 가치 (예 : 회사, 제품 등)에 대한 변경은 일반적으로 드물고 관리하기가 쉽지 않으므로 DRY 를 고려해야하는 것은 아닙니다 . 모든 프로젝트의 값을 일회성으로 수동으로 변경 하려면 다음 MSBuild 스크립트 ( MSBuild 확장 팩 에 따라 다름)를 실행하십시오 .
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" DefaultTargets="UpdateAssemblyInfo" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<AllAssemblyInfoFiles Include="..\**\AssemblyInfo.cs" />
</ItemGroup>
<Import Project="MSBuild.ExtensionPack.tasks" />
<Target Name="UpdateAssemblyInfo">
<Message Text="%(AllAssemblyInfoFiles.FullPath)" />
<MSBuild.ExtensionPack.Framework.AssemblyInfo
AssemblyInfoFiles="@(AllAssemblyInfoFiles)"
AssemblyCompany="Company"
AssemblyProduct="Product"
AssemblyCopyright="Copyright"
... etc ...
/>
</Target>
</Project>여러 프로젝트에 단일 AseemblyInfo.cs 파일을 사용하지 않는 것이 좋습니다. AssemblyInfo 파일에는 해당 특정 어셈블리에만 관련 될 수있는 정보가 포함되어 있습니다. 가장 명백한 두 가지 정보는 AssemblyTitle및 AssemblyVersion입니다.
더 나은 솔루션은 targets둘 이상의 프로젝트에 어셈블리 속성을 "주입"하기 위해 MSBuild에서 처리 하는 파일 을 사용 하는 것입니다.
내가 찾은 유용한 것 중 하나는 빌드 전 단계에서 토큰 대체를 적용하여 AssemblyVersion 요소 등을 생성하는 것입니다.
TortoiseSvn을 사용하고 SubWCRev.exe템플릿을 AssemblyInfo.wcrev로 변환 하는 데 사용하기 쉽습니다 AssemblyInfo.cs. 템플릿의 관련 줄은 다음과 같습니다.
[assembly: AssemblyVersion("2.3.$WCREV$.$WCMODS?1:0$$WCUNVER?1:0$")]세 번째 요소는 개정 번호입니다. 네 번째 요소를 사용하여 새 파일이나 변경된 파일을 커밋하는 것을 잊어 버리지 않았는지 확인합니다 (네 번째 요소는 모두 00이면 00입니다).
그건 그렇고, AssemblyInfo.wcrev버전 컨트롤에 추가 하고 이것을 사용하면 무시 AssemblyInfo.cs 하십시오.