程序集清單

程序集清單(英語:assembly manifest)是.Net Framework中的文本文件,包含了CLI 程序集元數據,包括程序集的組建間的依賴關係、解決資源與類的引用、版本信息、作用域信息、安全許可等。[1]存儲在PE文件(.exe或.dll)用通用中間語言 (MSIL) 代碼表示。

嵌入到程序集中的程序集清單可用Windows SDK中的IL反匯編程序(ILDASM.exe)查看。

程序集清單的內容

下表的前四行:程序集名字、版本號、culture、強名字信息,組成了程序集的identity。

程序集清單的內容
信息 描述
Assembly name 一個文本字符串指出程序集的名字。
Version number 主版本號、次版本號、revision號、build號。通用語言運行時使用這些版本號執行版本政策(version policy)。
Culture 該程序集支持的文化或語言的信息。 一個帶有culture信息的程序集自動被認為是一個satellite程序集。
Strong name information 對於一個被給定一個強名字程序集,發布者的公鑰
程序集中所有文件的列表 包含在程序集中的每個文件的哈希值與文件名。注意,組成程序集的所有文件必須在包含了程序集清單的文件所在的目錄中。
類型推導信息 對於程序集輸出的類型,通用語言運行時使用該信息把類型推導映射到包含了該類型聲明與實現的那個文件。
被引用的程序集的信息 當前程序集靜態引用的其他程序集的列表。每個引用包含了被依賴的程序集的名字、版本、culture、操作系統等等,以及公鑰(如果被依賴的程序集是強名字)。

.NET實現

Manifest是一個以.manifest為後綴的XML文件。其內部的信息:

  • <assemblyIdentity>元素則標識着一個唯一的程序集
  • 指定了組成程序集的文件及Windows類。

操作系統首先讀取Manifest,獲得exe文件需要調用的DLL的manifest。再根據據此信息去尋找對應的DLL。這樣就可能區別不同版本的同一個DLL文件。

共享程序集的Manifests存儲在WINDOWS/WinSxS/Manifests目錄中。這是Windows XP以上版本操作系統提供的非託管(多版本)並行緩存(side-by-side cache)中安裝了強名字的系統庫的程序集清單。在WinSxS目錄下,每個程序集都會有一個目錄,另外,還有兩個目錄分別是Manifests和Policies,其中包含了版本的相關信息。例如:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
	<noInheritable></noInheritable>
	<assemblyIdentity type="win32" name="Microsoft.VC80.CRT" version="8.0.50727.42" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3b"></assemblyIdentity>
	<file name="msvcr80.dll" hash="2a0d797a8c5eac76e54e98db9682e0938c614b45" hashalg="SHA1">
		<asmv2:hash xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">
			<dsig:Transforms>
				<dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity"></dsig:Transform>
			</dsig:Transforms>
			<dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></dsig:DigestMethod>
			<dsig:DigestValue>phRUExlAeZ8BwmlD8VlO5udAnRE=</dsig:DigestValue>
		</asmv2:hash>
	</file>
	<file name="msvcp80.dll" hash="cc4ca55fb6aa6b7bb8577ab4b649ab77e42f8f91" hashalg="SHA1">
		<asmv2:hash xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">
			<dsig:Transforms>
				<dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity"></dsig:Transform>
			</dsig:Transforms>
			<dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></dsig:DigestMethod>
			<dsig:DigestValue>7AY1JqoUvK3u/6bYWbOagGgAFbc=</dsig:DigestValue>
		</asmv2:hash>
	</file>
	<file name="msvcm80.dll" hash="55e8e87bbde00d1d96cc119ccd94e0c02c9a2768" hashalg="SHA1">
		<asmv2:hash xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">
			<dsig:Transforms>
				<dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity"></dsig:Transform>
			</dsig:Transforms>
			<dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></dsig:DigestMethod>
			<dsig:DigestValue>hWq8zazTsMeKVxWFBa6bnv4hEOw=</dsig:DigestValue>
		</asmv2:hash>
	</file>
</assembly>

使用者:

<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'>
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type='win32' name='Microsoft.VC80.CRT' version='8.0.50608.0' processorArchitecture='x86' publicKeyToken='1fc8b3b9a1e18e3b' />
    </dependentAssembly>
  </dependency>
</assembly>

在WINDOWS/WinSxS/Policies目錄下的Policy文件,來指出老版本到新版本的確認映射關係。解決庫升級帶來的版本兼容問題。例如:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- Copyright ? 1981-2001 Microsoft Corporation -->
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
	<assemblyIdentity type="win32-policy" name="policy.8.0.Microsoft.VC80.CRT" version="8.0.50727.42" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3b"/>
	<dependency>
		<dependentAssembly>
			<assemblyIdentity type="win32" name="Microsoft.VC80.CRT" processorArchitecture="x86" publicKeyToken="1fc8b3b9a1e18e3b"/>
			<bindingRedirect oldVersion="8.0.41204.256-8.0.50608.0" newVersion="8.0.50727.42"/>
		</dependentAssembly>
	</dependency>
</assembly>

其中<bindingRedirect>標籤便指定了所有8.0.41204.256-8.0.50608.0版本的需求,映射到8.0.50727.42這個系統中安裝的比較新的版本的庫。

參考文獻

  1. ^ .NET 中的程序集 at MSDN. [2019-07-04]. (原始內容存檔於2019-07-04).