Манифест развертывания ClickOnce

Статья
11/16/2008

Обновлен: Ноябрь 2007

Манифест развертывания — это файл XML, описывающий развертывание ClickOnce, включая идентификацию текущей версии развертываемого приложения ClickOnce.

Манифесты развертывания имеют следующие элементы и атрибуты.

Элемент	Описание	Атрибуты
Элемент <assembly>	Обязательный. Элемент верхнего уровня.	manifestVersion
Элемент <assemblyIdentity>	Обязательный. Определение манифеста приложения для приложения ClickOnce.	name version publicKeyToken processorArchitecture culture
Элемент <description>	Обязательный. Определение сведений о приложении, используемом для создания оболочки присутствия и элемента Установка и удаление программ в панели управления.	publisher product supportUrl
Элемент <deployment>	Необязательный. Определение атрибутов, используемых для развертывания обновлений и доступа к системе.	isRequiredUpdate
Элемент <dependency>	Обязательный. Определение версии приложения, устанавливаемого для развертывания, и расположения манифеста приложения.	Отсутствует
Элемент <Signature>	Необязательный. Содержит сведения, необходимые для цифровой подписи данного манифеста развертывания.	нет

Заметки

Файл манифеста развертывания определяет развертывание приложения ClickOnce, включая текущую версию и другие настройки развертывания. Он ссылается на манифест приложения, описывающий текущую версию приложения и все файлы, задействованные в развертывании.

Дополнительные сведения см. в разделе Обзор развертывания ClickOnce.

Расположение файла

Файл манифеста развертывания ссылается на правильный манифест приложения для текущей версии приложения. Когда станет доступна новая версия развертывания приложения, необходимо обновить манифест развертывания ссылкой на новый манифест приложения.

Файл манифеста развертывания должен иметь строгое имя и может также содержать сертификаты для проверки издателя.

Синтаксис имени файла

Имя файла манифеста развертывания должно заканчиваться расширением .application.

Примеры

В следующих примерах кода показан манифест развертывания для двух стандартных типов развертывания.

В первом примере показан манифест развертывания для запуска приложения ClickOnce. Запускаемое приложение ClickOnce не добавляется в меню Пуск или Установка и удаление программ операционной системы Windows и всегда использует самую последнюю версию.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xrml="urn:mpeg:mpeg21:2003:01-REL-R-NS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <assemblyIdentity name="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="false" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" type="win32" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>

  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>

Во втором примере показан манифест развертывания для установленного приложения ClickOnce, который выполняет проверку на наличие обновлений перед запуском приложения. Установленное приложение ClickOnce добавляется в меню Пуск операционной системы Windows, а на панель управления добавляется элемент Установка и удаление программ. Он также задает тег <deploymentProvider>, который описывает альтернативное размещение для опроса на наличие обновлений приложения.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xrml="urn:mpeg:mpeg21:2003:01-REL-R-NS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <assemblyIdentity name="ValidateChildrenWithConstraints.app" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description asmv2:publisher="MS" asmv2:product="Validate With Constraints" xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true" minimumRequiredVersion="1.0.0.0" trustURLParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="2" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="https://localhost/ValidateChildrenWithConstraints.application" />
  </deployment>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="Debug\ValidateChildrenWithConstraints.exe.manifest" size="5912">
      <assemblyIdentity name="ValidateChildrenWithConstraints.exe" version="1.0.0.0" publicKeyToken="6c3d632f25ac9964" language="neutral" processorArchitecture="msil" type="win32" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>RokPpIeGiPcO/+UUi5thetccDTc=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  
  <Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
    ...
  </Signature>
</asmv1:assembly>