Manifiesto de implementación de ClickOnce

Artículo
03/18/2023

Un manifiesto de implementación es un archivo XML que describe una implementación ClickOnce, incluida la identificación de la versión de la aplicación ClickOnce actual que se va a implementar.

Los manifiestos de implementación tienen los siguientes elementos y atributos.

Elemento	Descripción	Atributos
Elemento <assembly>	Necesario. Elemento de nivel superior.	`manifestVersion`
Elemento <assemblyIdentity>	Necesario. Identifica el manifiesto de aplicación de la aplicación ClickOnce.	`name` `version` `publicKeyToken` `processorArchitecture` `culture`
Elemento <description>	Necesario. Identifica la información de la aplicación utilizada para crear una presencia de shell y el elemento Agregar o quitar programas en el Panel de control.	`publisher` `product` `supportUrl`
Elemento <deployment>	Opcional. Identifica los atributos utilizados para la implementación de actualizaciones y la exposición del sistema.	`install` `minimumRequiredVersion` `mapFileExtensions` `disallowUrlActivation` `trustUrlParameters`
Elemento <compatibleFrameworks>	Necesario. Identifica las versiones de .NET Framework en las que se puede instalar y ejecutar esta aplicación.	`SupportUrl`
Elemento <dependency>	Necesario. Identifica la versión de la aplicación que se va a instalar para la implementación y la ubicación del manifiesto de aplicación.	`preRequisite` `visible` `dependencyType` `codebase` `size`
Elemento <publisherIdentity>	Requerido para los manifiestos firmados. Contiene información sobre el editor que firmó este manifiesto de implementación.	`Name` `issuerKeyHash`
Elemento <Signature>	Opcional. Contiene la información necesaria para firmar digitalmente este manifiesto de implementación.	None
Elemento <customErrorReporting>	Opcional. Especifica un URI que se va a mostrar cuando se produce un error.	Identificador URI

Observaciones

El archivo de manifiesto de implementación identifica una implementación de aplicación de ClickOnce, incluida la versión actual y otras configuraciones de implementación. Hace referencia al manifiesto de aplicación, que describe la versión actual de la aplicación y todos los archivos contenidos en la implementación.

Para obtener más información, consulta ClickOnce Security and Deployment.

Ubicación del archivo

El archivo de manifiesto de implementación hace referencia al manifiesto de aplicación correcto para la versión actual de la aplicación. Al crear una nueva versión de una implementación de aplicación disponible, debe actualizar el manifiesto de implementación para que haga referencia al nuevo manifiesto de aplicación.

El archivo de manifiesto de implementación debe tener un nombre seguro y también puede contener certificados para la validación del editor.

Sintaxis de los nombres de archivo

El nombre de un archivo de manifiesto de implementación debe terminar con la extensión .application.

Ejemplos

El ejemplo de código siguiente muestra un manifiesto de implementación.

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

Consulte también

Publicación de aplicaciones ClickOnce