166

我有一个包含多个项目的解决方案。我正在尝试通过链接一个解决方案范围的程序集信息文件来优化 AssemblyInfo.cs 文件。这样做的最佳做法是什么?哪些属性应该在解决方案范围的文件中,哪些是项目/程序集特定的?


编辑:如果您有兴趣,有一个后续问题AssemblyVersion、AssemblyFileVersion 和 AssemblyInformationalVersion 之间有什么区别?

4

8 回答 8

212

我们正在使用一个名为 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:

  • 在项目的上下文菜单中选择Add/Existing Item...
  • 选择 GlobalAssemblyInfo.cs
  • 通过单击右侧的那个小向下箭头来展开添加按钮
  • 在按钮下拉列表中选择“添加为链接”
于 2008-09-15T13:04:38.270 回答
21

在我的例子中,我们正在构建一个产品,我们有一个 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 都内置到每个程序集中。这为我们提供了两全其美的优势,您可能希望为所有项目提供一些共同属性,并为其他一些项目提供特定值。

希望有帮助。

于 2008-09-15T13:14:27.077 回答
16

@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”值。

于 2008-09-15T14:01:20.477 回答
8

MSBuild 社区任务包含一个名为 AssemblyInfo 的自定义任务,您可以使用它来生成您的 assemblyinfo.cs。它需要对您的 csproj 文件进行一点手工编辑才能使用,但这是值得的。

于 2008-09-15T13:45:44.040 回答
6

在我看来,使用 GlobalAssemblyInfo.cs 比它的价值更麻烦,因为您需要修改每个项目文件并记住修改每个新项目,而默认情况下您会得到一个 AssemblyInfo.cs。

对于全局值(即公司、产品等)的更改,这些更改通常很少且易于管理,我认为DRY不应该是一个考虑因素。当您想要一次性手动更改所有项目中的值时,只需运行以下 MSBuild 脚本(依赖于MSBuild Extension Pack ):

<?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>
于 2014-08-04T11:18:09.233 回答
3

要在多个项目之间共享文件,您可以将现有文件添加为链接。

为此,请添加一个现有文件,然后单击文件选择器中的“添加为链接”。(来源:free.fr添加为链接

至于在共享文件中放置什么,我建议放置将跨程序集共享的东西。诸如版权,公司,也许是版本之类的东西。

于 2008-09-15T13:10:38.677 回答
1

我发现有用的一件事是通过在预构建阶段应用令牌替换来生成 AssemblyVersion 元素(等)。

我使用 TortoiseSvn,它很容易将SubWCRev.exe模板AssemblyInfo.wcrev转换为AssemblyInfo.cs. 模板中的相关行可能如下所示:

[assembly: AssemblyVersion("2.3.$WCREV$.$WCMODS?1:0$$WCUNVER?1:0$")]

第三个元素是修订号。我使用第四个元素来检查我没有忘记提交任何新的或更改的文件(如果一切正常,第四个元素是 00)。

顺便说一句,添加AssemblyInfo.wcrev到您的版本控制中,如果您使用它,请忽略。 AssemblyInfo.cs

于 2016-09-06T15:06:06.463 回答
0

不建议对多个项目使用单个 AseemblyInfo.cs 文件。AssemblyInfo 文件包含可能仅与该特定程序集相关的信息。最明显的两条信息是AssemblyTitleAssemblyVersion

更好的解决方案可能是使用targets由 MSBuild 处理的文件,以便将程序集属性“注入”到多个项目。

于 2008-09-15T13:04:04.577 回答