Манифест развертывания ClickOnceClickOnce deployment manifest

Манифест развертывания — это XML-файл, который описывает развертывание ClickOnceClickOnce, включая идентификацию текущей версии приложения ClickOnceClickOnce для развертывания.A deployment manifest is an XML file that describes a ClickOnceClickOnce deployment, including the identification of the current ClickOnceClickOnce application version to deploy.

Манифесты развертывания имеют следующие элементы и атрибуты.Deployment manifests have the following elements and attributes.

ЭлементElement ОписаниеDescription АтрибутыAttributes
Элемент <assembly><assembly> Element Обязательный.Required. Это элемент верхнего уровня.Top-level element. manifestVersion
Элемент <assemblyIdentity><assemblyIdentity> Element Обязательный.Required. Идентифицирует манифест приложения для приложения ClickOnceClickOnce.Identifies the application manifest for the ClickOnceClickOnce application. name

version

publicKeyToken

processorArchitecture

culture
Элемент <description><description> Element Обязательный.Required. Идентифицирует сведения о приложении, используемые для обеспечения присутствия оболочки, и элемент Установка и удаление программ на панели управления.Identifies application information used to create a shell presence and the Add or Remove Programs item in Control Panel. publisher

product

supportUrl
Элемент <deployment><deployment> Element Необязательный параметр.Optional. Идентифицирует атрибуты, используемые для развертывания обновлений и доступа к системе.Identifies the attributes used for the deployment of updates and exposure to the system. install

minimumRequiredVersion

mapFileExtensions

disallowUrlActivation

trustUrlParameters
Элемент <compatibleFrameworks><compatibleFrameworks> Element Обязательный.Required. Идентифицирует версии платформы .NET Framework, где можно установить и выполнять это приложение.Identifies the versions of the .NET Framework where this application can install and run. SupportUrl
Элемент <dependency><dependency> Element Обязательный.Required. Идентифицирует устанавливаемую версию приложения для развертывания и местоположение манифеста приложения.Identifies the version of the application to install for the deployment and the location of the application manifest. preRequisite

visible

dependencyType

codebase

size
Элемент <publisherIdentity><publisherIdentity> Element Является обязательным для манифестов с подписью.Required for signed manifests. Содержит сведения об издателе, подписавшем этот манифест развертывания.Contains information about the publisher that signed this deployment manifest. Name

issuerKeyHash
Элемент <Signature><Signature> Element Необязательный параметр.Optional. Содержит сведения, необходимые для того, чтобы подписать этот манифест развертывания с помощью цифровой подписи.Contains the necessary information to digitally sign this deployment manifest. НетNone
Элемент <customErrorReporting><customErrorReporting> Element Необязательный параметр.Optional. Задает отображаемый в случае ошибки URI.Specifies a URI to show when an error occurs. URIUri

ПримечанияRemarks

Файл манифеста развертывания определяет развертывание приложения ClickOnceClickOnce, включая текущую версию и другие настройки развертывания.The deployment manifest file identifies a ClickOnceClickOnce application deployment, including the current version and other deployment settings. Он ссылается на манифест приложения, описывающий текущую версию приложения и все файлы, задействованные в развертывании.It references the application manifest, which describes the current version of the application and all of the files contained within the deployment.

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

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

Файл манифеста развертывания ссылается на правильный манифест приложения для текущей версии приложения.The deployment manifest file references the correct application manifest for the current version of the application. Когда новая версия развертывания приложения становится доступной, необходимо обновить манифест развертывания, чтобы он ссылался на новый манифест приложения.When you make a new version of an application deployment available, you must update the deployment manifest to refer to the new application manifest.

Файл манифеста развертывания должен иметь строгое имя и может также содержать сертификаты для проверки издателя.The deployment manifest file must be strongly named and can also contain certificates for publisher validation.

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

Имя файла манифеста развертывания должно оканчиваться расширением .application.The name of a deployment manifest file must end with the .application extension.

ПримерыExamples

Манифест развертывания показан в следующем примере кода.The following code example illustrates a deployment manifest.

<?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>

См. такжеSee also