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

Статья
10/10/2023

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

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

Элемент	Description	Атрибуты
<Элемент assembly>	Обязательно. Это элемент верхнего уровня.	`manifestVersion`
<Элемент assemblyIdentity>	Обязательно. Определяет манифест приложения для приложения ClickOnce.	`name` `version` `publicKeyToken` `processorArchitecture` `culture`
<Элемент description>	Обязательно. Идентифицирует сведения о приложении, используемые для обеспечения присутствия оболочки, и элемент Установка и удаление программ на панели управления.	`publisher` `product` `supportUrl`
<Элемент deployment>	Необязательно. Идентифицирует атрибуты, используемые для развертывания обновлений и доступа к системе.	`install` `minimumRequiredVersion` `mapFileExtensions` `disallowUrlActivation` `trustUrlParameters`
<Элемент compatibleFrameworks>	Обязательно. Идентифицирует версии платформы .NET Framework, где можно установить и выполнять это приложение.	`SupportUrl`
<Элемент зависимостей>	Обязательно. Идентифицирует устанавливаемую версию приложения для развертывания и местоположение манифеста приложения.	`preRequisite` `visible` `dependencyType` `codebase` `size`
<Элемент publisherIdentity>	Является обязательным для манифестов с подписью. Содержит сведения об издателе, подписавшем этот манифест развертывания.	`Name` `issuerKeyHash`
<Элемент Signature>	Необязательно. Содержит сведения, необходимые для того, чтобы подписать этот манифест развертывания с помощью цифровой подписи.	нет
<Элемент customErrorReporting>	Необязательно. Задает отображаемый в случае ошибки URI.	URI-адрес

Замечания

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

Для получения дополнительной информации см. ClickOnce Security and Deployment.

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

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

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

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

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

Примеры

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

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd"
  manifestVersion="1.0"
  xmlns:asmv3="urn:schemas-microsoft-com:asm.v3"
  xmlns:dsig=http://www.w3.org/2000/09/xmldsig#
  xmlns:co.v1="urn:schemas-microsoft-com:clickonce.v1"
  xmlns:co.v2="urn:schemas-microsoft-com:clickonce.v2"
  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="My Application Deployment.app"
    version="1.0.0.0"
    publicKeyToken="43cb1e8e7a352766"
    language="neutral"
    processorArchitecture="x86"
    xmlns="urn:schemas-microsoft-com:asm.v1" />
  <description
    asmv2:publisher="My Company Name"
    asmv2:product="My Application"
    xmlns="urn:schemas-microsoft-com:asm.v1" />
  <deployment install="true">
    <subscription>
      <update>
        <expiration maximumAge="0" unit="days" />
      </update>
    </subscription>
    <deploymentProvider codebase="\\myServer\sampleDeployment\MyApplicationDeployment.application" />
  </deployment>
  <compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2">
    <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.20506" />
    <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.20506" />
  </compatibleFrameworks>
  <dependency>
    <dependentAssembly
      dependencyType="install"
      codebase="1.0.0.0\My Application Deployment.exe.manifest"
      size="6756">
      <assemblyIdentity
        name="My Application Deployment.exe"
        version="1.0.0.0"
        publicKeyToken="43cb1e8e7a352766"
        language="neutral"
        processorArchitecture="x86"
        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>E506x9FwNauks7UjQywmzgtd3FE=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
<publisherIdentity name="CN=DOMAIN\MyUsername" issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
...
</Signature></asmv1:assembly>

См. также

Публикация приложений ClickOnce

Поделиться через