Elemento <dependency> (Aplicación ClickOnce)

Artículo
10/07/2008

Actualización: Julio de 2008

Identifica una plataforma o dependencia de ensamblado requerida para la aplicación.

<dependency>
   <dependentOS
      supportURL
      description
   >
      <osVersionInfo>
         <os
            majorVersion
            minorVersion
            buildNumber
            servicePackMajor
            servicePackMinor
            productType
            suiteType
         /> 
      </osVersionInfo>
   </dependentOS>
   <dependentAssembly
      codeBase
      size
   >
      <assemblyIdentity
         name
         version
         processorArchitecture
         language
      >
         <hash>
            <dsig:Transforms>
               <dsig:Transform
                  Algorithm
            />
            </dsig:Transforms>
            <dsig:DigestMethod />
            <dsig:DigestValue>
            </dsig:DigestValue>
    </hash>

      </assemblyIdentity>
   </dependentAssembly>
</dependency>

Elementos y atributos

Se requiere el elemento dependency. Puede haber varias instancias de dependency en el mismo manifiesto de aplicación.

El elemento dependency no contiene atributos y contiene los siguientes elementos secundarios.

dependentOS

Opcional. Contiene el elemento osVersionInfo. Los elementos dependentOS y dependentAssembly se excluyen mutuamente: uno de los dos debe existir para un elemento dependency, pero no ambos.

dependentOS admite los siguientes atributos.

Atributo	Descripción
supportUrl	Opcional. Especifica una dirección URL de soporte para la plataforma dependiente. La dirección URL se muestra al usuario si se encuentra la plataforma necesaria.
description	Opcional. Describe, de forma legible para el usuario, el sistema operativo descrito por el elemento dependentOS.

osVersionInfo

Obligatorio. Este elemento es un elemento secundario del elemento dependentOS y contiene el elemento os. Este elemento no tiene ningún atributo.

os

Obligatorio. Este elemento es secundario del elemento osVersionInfo. Este elemento presenta los atributos siguientes.

Atributo	Descripción
majorVersion	Obligatorio. Especifica el número de versión principal del sistema operativo.
minorVersion	Obligatorio. Especifica el número de versión secundario del sistema operativo.
buildNumber	Obligatorio. Especifica el número de compilación del sistema operativo.
servicePackMajor	Obligatorio. Especifica el número principal del Service Pack del sistema operativo.
servicePackMinor	Opcional. Especifica el número secundario del Service Pack del sistema operativo.
productType	Opcional. Identifica el valor del tipo de producto. Los valores válidos son server, workstation y domainController. Por ejemplo, para Windows 2000 Professional, este valor de atributo es workstation.
suiteType	Opcional. Identifica un conjunto de productos disponible en el sistema o el tipo de configuración del sistema. Los valores válidos son backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted y terminal. Por ejemplo, para Windows 2000 Professional, este valor de atributo es professional.

dependentAssembly

Opcional. Contiene el elemento assemblyIdentity. Los elementos dependentOS y dependentAssembly se excluyen mutuamente: uno de los dos debe existir para un elemento dependency, pero no ambos.

dependentAssembly tiene los atributos siguientes.

Atributo	Descripción
`codeBase`	Obligatorio. La ruta de acceso al ensamblado representado por este ensamblado. Puede ser una ruta de acceso absoluta o una ruta de acceso relativa a la base del código del manifiesto. Esta ruta de acceso debe ser un Identificador uniforme de recursos URI válido para que el manifiesto del ensamblado sea válido.
size	Obligatorio. El tamaño del ensamblado dependiente, en bytes.

assemblyIdentity

Obligatorio. Es un elemento secundario del elemento dependentAssembly y tiene los atributos siguientes.

Atributo	Descripción
name	Obligatorio. Identifica el nombre de la aplicación.
version	Obligatorio. Especifica el número de versión de la aplicación en el formato siguiente: major.minor.build.revision
publicKeyToken	Opcional. Especifica una cadena hexadecimal de 16 caracteres que representa los últimos 8 bytes del valor hash SHA-1 de la clave pública bajo la que se firma la aplicación o el ensamblado. La clave pública utilizada para firmar el catálogo debe tener 2048 bits o más.
processorArchitecture	Opcional. Especifica el procesador. Los valores válidos son x86 para Windows de 32 bits y I64 para Windows de 64 bits.
language	Opcional. Identifica los códigos de idioma de dos partes del ensamblado (por ejemplo, EN-US).

hash

El elemento hash es un elemento secundario opcional del elemento assemblyIdentity. El elemento hash no tiene atributos.

ClickOnce utiliza un valor hash algorítmico de todos los archivos de una aplicación como comprobación de seguridad para asegurarse de que no se modificó ninguno de los archivos después de la implementación. Si el elemento hash no está incluido, no se realizará esta comprobación. No resulta recomendable, por tanto, omitir hash.

dsig:Transforms

El elemento dsig:Transforms es un elemento secundario necesario del elemento hash. El elemento dsig:Transforms no tiene atributos.

dsig:Transform

El elemento dsig:Transform es un elemento secundario necesario del elemento dsig:Transforms. El elemento dsig:Transform presenta los atributos siguientes.

Atributo	Descripción
Algorithm	Algoritmo que se utiliza para calcular la síntesis de este archivo. En la actualidad, el único valor utilizado por ClickOnce es urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

El elemento dsig:DigestMethod es un elemento secundario necesario del elemento hash. El elemento dsig:DigestMethod presenta los atributos siguientes.

Atributo	Descripción
Algorithm	Algoritmo que se utiliza para calcular la síntesis de este archivo. En la actualidad, el único valor utilizado por ClickOnce es http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

El elemento dsig:DigestValue es un elemento secundario necesario del elemento hash. El elemento dsig:DigestValue no tiene atributos. Su valor de texto es el valor hash calculado para el archivo especificado.

Comentarios

Todos los ensamblados que utiliza la aplicación deben tener un elemento dependency correspondiente. Los ensamblados dependientes no incluyen ensamblados que se deban preinstalar en la caché de ensamblados global como ensamblados de plataforma.

Ejemplo

En el siguiente ejemplo de código se muestran elementos dependency en un manifiesto de aplicación de ClickOnce. Este ejemplo de código forma parte de un ejemplo más extenso que aparece en el tema Manifiesto de aplicación ClickOnce.

<!-- This XML identifies a SpellingChecker assembly. -->
<dependency>
  <dependentAssembly codebase="SpellingChecker.dll" size="29696">
    <assemblyIdentity name="SpellingChecker" version="2.0.0.0" publicKeyToken="e8ed396099c4b4e9" processorArchitecture="msil" language="es-PE" />
    <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>2+33lqQoPphgov907Kfp1v4TZMw=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

<!-- This XML describes an operating system dependency for the application. -->
<!--Microsoft Windows Operating System Platform Dependency-->
<dependency>
  <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
    <osVersionInfo>
      <os majorVersion="4" minorVersion="10" />
    </osVersionInfo>
  </dependentOS>
</dependency>

Vea también

Referencia

Manifiesto de aplicación ClickOnce

Historial de cambios

Fecha	Historial	Motivo
Julio de 2008	Se agregó información opcional sobre el elemento hash.	Mejora de la información.

Julio de 2008

Se agregó información opcional sobre el elemento hash.

Mejora de la información.

Share via