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

  • Статья

Манифест развертывания — это 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>

См. также