Elemento <dependency> (aplicación ClickOnce)

Artículo
03/18/2023

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>