Elemento <dependency> (aplicación ClickOnce)

  • Artículo

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

Sintaxis


      <dependency>
   <dependentOS
      supportURL
      description
   >
      <osVersionInfo>
         <os
            majorVersion
            minorVersion
            buildNumber
            servicePackMajor
            servicePackMinor
            productType
            suiteType
         />
      </osVersionInfo>
   </dependentOS>
   <dependentAssembly
      dependencyType
      allowDelayedBinding
      group
      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

El elemento dependency es obligatorio. Puede haber varias instancias de dependency en el mismo manifiesto de aplicación.

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

dependentOS

Opcional. Contiene el elemento osVersionInfo. Los elementos dependentOS y dependentAssembly son mutuamente excluyentes: deben existir uno u otro para un elemento dependency, pero no ambos.

dependentOS admite los atributos siguientes.

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

osVersionInfo

Necesario. Este elemento es un elemento secundario del elemento dependentOS y contiene el elemento os . Este elemento no tiene atributos.

os

Necesario. Este elemento es un elemento secundario del elemento osVersionInfo . Este elemento tiene los atributos siguientes.

Atributo Descripción
majorVersion Necesario. Especifica el número de versión principal del sistema operativo.
minorVersion Necesario. Especifica el número de versión secundaria del sistema operativo.
buildNumber Necesario. Especifica el número de compilación del sistema operativo.
servicePackMajor Necesario. Especifica el número principal de Service Pack del sistema operativo.
servicePackMinor Opcional. Especifica el número secundario de Service Pack del sistema operativo.
productType Opcional. Identifica el valor del tipo de producto. Valores válidos son server, workstation y domainController. Por ejemplo, para Windows 10, 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 son mutuamente excluyentes: deben existir uno u otro para un elemento dependency, pero no ambos.

dependentAssembly tiene los atributos siguientes.

Atributo Descripción
dependencyType Necesario. Especifica el tipo de dependencia. Los valores válidos son prerequisite y install. Un ensamblado install se instala como parte de la aplicación ClickOnce. Un ensamblado prerequisite debe estar presente en la caché global de ensamblados (GAC) para poder instalar la aplicación ClickOnce.
allowDelayedBinding Necesario. Especifica si el ensamblado se puede cargar mediante programación en tiempo de ejecución.
group Opcional. Si el atributo dependencyType está establecido en install, designa un grupo con nombre de ensamblados que solo se instalan a petición. Para obtener más información, vea Tutorial: Descarga de ensamblados a petición con la API de implementación ClickOnce mediante el diseñador.

Si está establecido en framework y el atributo dependencyType está establecido en prerequisite, designa el ensamblado como parte de .NET Framework. La caché global de ensamblados (GAC) no se comprueba para este ensamblado al instalar en .NET Framework 4 y versiones posteriores.
codeBase Elemento obligatorio cuando el atributo dependencyType está establecido en install. Ruta de acceso al ensamblado dependiente. Puede ser una ruta de acceso absoluta o una ruta de acceso relativa a la base de código del manifiesto. Esta ruta de acceso debe ser un URI válido para que el manifiesto del ensamblado sea válido.
size Elemento obligatorio cuando el atributo dependencyType está establecido en install. Tamaño del ensamblado dependiente, en bytes.

assemblyIdentity

Necesario. Este elemento es un elemento secundario del elemento dependentAssembly y tiene los atributos siguientes.

Atributo Descripción
name Necesario. Identifica el nombre de la aplicación.
version Necesario. 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 de hash SHA-1 de la clave pública con la que se firma la aplicación o el ensamblado. La clave pública usada para firmar el catálogo debe ser de 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, por ejemplo EN-US, del ensamblado.

hash

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

ClickOnce usa un hash algorítmico de todos los archivos de una aplicación como comprobación de seguridad para asegurarse de que ninguno de los archivos se ha cambiado después de la implementación. Si el elemento hash no está incluido, no se realizará esta comprobación. Por tanto, no se recomienda omitir el elemento hash.

dsig:Transforms

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

dsig:Transform

El elemento dsig:Transform es un elemento secundario obligatorio del elemento dsig:Transforms. El elemento dsig:Transform tiene los atributos siguientes:

Atributo Descripción
Algorithm Algoritmo utilizado para calcular el hash de este archivo. Actualmente, el único valor usado por ClickOnce es urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

El elemento dsig:DigestMethod es un elemento secundario obligatorio del elemento hash. El elemento dsig:DigestMethod tiene los atributos siguientes:

Atributo Descripción
Algorithm Algoritmo utilizado para calcular el hash de este archivo. Actualmente, el único valor usado por ClickOnce es http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

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

Observaciones

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

Ejemplo

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

<dependency>
  <dependentOS>
    <osVersionInfo>
      <os
        majorVersion="4"
        minorVersion="10"
        buildNumber="0"
        servicePackMajor="0" />
    </osVersionInfo>
  </dependentOS>
</dependency>
<dependency>
  <dependentAssembly
    dependencyType="preRequisite"
    allowDelayedBinding="true">
    <assemblyIdentity
      name="Microsoft.Windows.CommonLanguageRuntime"
      version="4.0.20506.0" />
  </dependentAssembly>
</dependency>

<dependency>
  <dependentAssembly
    dependencyType="install"
    allowDelayedBinding="true"
    codebase="MyApplication.exe"
    size="4096">
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <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>DpTW7RzS9IeT/RBSLj54vfTEzNg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

Consulte también