CLR via C# 读书笔记2-5

程序集的版本资源信息

使用 AL.exe 或 CSC.exe 生成的程序集都会包含一个标准 Win32 版本资源，通过查看这个文件的属性可以查看该信息，也可以在程序代码中调用System.Diagnostics.FileVersionInfo 的静态方法 GetVersionInfo 来查看。图 2-4 显示了之前生成的 MultiFileLibrary.dll 属性对话框：

可以通过设定自定义属性(custom attributes)来设定版本信息，请参见下面的代码片断：

using System.Reflection;// FileDescription version information:[assembly: AssemblyTitle("MultiFileLibrary.dll")]// Comments version information:[assembly: AssemblyDescription("This assembly contains MultiFileLibrary's types")]// CompanyName version information:[assembly: AssemblyCompany("Wintellect")]// ProductName version information:[assembly: AssemblyProduct("Wintellect (R) MultiFileLibrary's Type Library")]// LegalCopyright version information:[assembly: AssemblyCopyright("Copyright (c) Wintellect 2013")]// LegalTrademarks version information:[assembly:AssemblyTrademark("MultiFileLibrary is a registered trademark of Wintellect")]// AssemblyVersion version information:[assembly: AssemblyVersion("3.0.0.0")]// FILEVERSION/FileVersion version information:[assembly: AssemblyFileVersion("1.0.0.0")]// PRODUCTVERSION/ProductVersion version information:[assembly: AssemblyInformationalVersion("2.0.0.0")]// Set the Language field (discussed later in the "Culture" section)[assembly:AssemblyCulture("")]

可惜的是Windows 的资源管理器中并没有提供查看以上所有设定值的功能，表2-4 列出了各个版本资源字段与自定义属性之间的对应关系。另外如果在 AL.exe 生成程序集时，可以使用命令开关来设置这些信息，表2-4的第二列记录了这些开关。（C# 编译器并没有这些命令开关）

表2-4

版本资源AL.exe 命令开关自定义属性/备注FILEVERSION/fileversionSystem.Reflection.AssemblyFileVersionAttributePRODUCTVERSION/productversionSystem.Reflection.AssemblyInformationalVersionAttributeFILEFLAGSMASK(none)总为 VS_FFI_FILEFLAGSMASK (定义在 WinVer.h 中，值为 0x0000003F)FILEFLAGS(none)总为 0FILEOS(none)目前总为 VOS__WINDOWS32.FILETYPE/target

当 /target:exe 或 /target:winexe 时，设为VFT_APP
当 /target:library 时，设为VFT_DLL

FILESUBTYPE(none)总为 VFT2_UNKNOWNAssemblyVersion/versionSystem.Reflection.AssemblyVersionAttributeComments/descriptionSystem.Reflection.AssemblyDescriptionAttributeCompanyName/companySystem.Reflection.AssemblyCompanyAttributeFileDescription/titleSystem.Reflection.AssemblyTitleAttributeFileVersion/versionSystem.Reflection.AssemblyFileVersionAttributeInternalName/out设定为出力文件名 (不含扩展名)LegalCopyright/copyrightSystem.Reflection.AssemblyCopyrightAttributeLegalTrademarks/trademarkSystem.Reflection.AssemblyTrademarkAttributeOriginalFilename/out设定为出力文件名 (不含路径)PrivateBuild(none)总为空ProductName/productSystem.Reflection.AssemblyProductAttributeProductVersion/productversionSystem.Reflection.AssemblyInformationalVersionAttributeSpecialBuild(none)总为空

 

使用 Visual Studio 的伙计请注意：建立工程时IDE自动生成一个 AssemblyInfo.cs 文件，你可以直接修改该文件中的版本信息，也可以在工程属性页中修改相关设定，这两者是同步的。

版本号具有固定的格式，可划分为4部分，如表2-5

表2-5

 Major NumberMinor NumberBuild NumberRevision Number

例

2

5

719

2

示例的版本号为： 2.5.719.2，前两个数字组成了公共认知的版本号（这是个2.5 版的程序集）。第3个数字用于表示编译的批次，如果你进行每日编译，那么应当每天递增这个值。最后的数字表示某次编译的校订版本，当你一日进行多次编译时或者对应突发bug需要再次编译时可以使用。

在程序集中使用版本号时，你会发现有多达3个版本信息可以设定！他们的不同点参见下文：

■ AssemblyFileVersion
该版本号存在 Win32 版本资源中，仅用来表示信息，CLR 不使用该信息。通常你可以设定这个信息来显示给公众（Windows 资源管理器可查看到该信息），与用户交流时通常也使用这个信息。
■ AssemblyInformationalVersion
该版本号也存在 Win32 版本资源中，也仅用来表示信息，CLR 不使用该信息。它用来指示包含该程序集的产品版本。例如： 一个 2.0 版的产品包含了多个程序集，其中一个程序集是新建的（即：1.0 版的产品中没有包含它），此时你可以设定 AssemblyInformationalVersion 的 major 和 minor 为产品的版本号，然后每次打包整个产品时递增 build 和 revision。
■ AssemblyVersion
该版本存在 AssemblyDef manifest 元数据表中 CLR 把它与强命名一起来唯一标示一个程序集。