<dependency> – element (aplikace ClickOnce)

Článek
01/12/2024

Identifikuje závislost platformy nebo sestavení, která je vyžadována pro aplikaci.

Syntaxe


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

Prvky a atributy

Prvek dependency je povinný. Ve stejném manifestu dependency aplikace může existovat více instancí.

Element dependency nemá žádné atributy a obsahuje následující podřízené prvky.

dependentOS

Nepovinné. osVersionInfo Obsahuje prvek. Prvky dependentOS se dependentAssembly vzájemně vylučují: jeden nebo druhý musí existovat pro dependency prvek, ale ne obojí.

dependentOS podporuje následující atributy.

Atribut	Popis
`supportUrl`	Nepovinné. Určuje adresu URL podpory pro závislou platformu. Tato adresa URL se uživateli zobrazí, pokud se najde požadovaná platforma.
`description`	Nepovinné. Popisuje operační systém popsaný elementem `dependentOS` v čitelné podobě.

osVersionInfo

Povinný: Tento prvek je podřízený prvek dependentOS a obsahuje os prvek. Tento prvek nemá žádné atributy.

Os

Povinný: Tento prvek je podřízený prvek osVersionInfo . Tento prvek má následující atributy.

Atribut	Popis
`majorVersion`	Požadováno. Určuje číslo hlavní verze operačního systému.
`minorVersion`	Povinný: Určuje číslo podverze operačního systému.
`buildNumber`	Povinný: Určuje číslo buildu operačního systému.
`servicePackMajor`	Povinný: Určuje hlavní číslo aktualizace Service Pack operačního systému.
`servicePackMinor`	Nepovinné. Určuje podverze aktualizace Service Pack operačního systému.
`productType`	Nepovinné. Identifikuje hodnotu typu produktu. Platné hodnoty jsou `server`, `workstation` a `domainController`. Například pro Windows 10 je tato hodnota atributu `workstation`.
`suiteType`	Nepovinné. Identifikuje sadu produktů dostupnou v systému nebo typ konfigurace systému. Platné hodnoty jsou `backoffice`, , `blade`, `datacenter`, `homeenterprisesmallbusinessprofessional`, , , `smallbusinessRestricted`, a .`terminal` Například pro Systém Windows 2000 Professional je tato hodnota atributu `professional`.

dependentAssembly

Nepovinné. assemblyIdentity Obsahuje prvek. Prvky dependentOS se dependentAssembly vzájemně vylučují: jeden nebo druhý musí existovat pro dependency prvek, ale ne obojí.

dependentAssembly má následující atributy.

Atribut	Popis
`dependencyType`	Požadováno. Určuje typ závislosti. Platné hodnoty jsou `prerequisite` a `install`. Sestavení `install` je nainstalováno jako součást aplikace ClickOnce. Před `prerequisite` instalací aplikace ClickOnce musí být sestavení v globální mezipaměti sestavení (GAC).
`allowDelayedBinding`	Povinný: Určuje, zda lze sestavení načíst programově za běhu.
`group`	Nepovinné. `dependencyType` Pokud je atribut nastaven na `install`, určuje pojmenovanou skupinu sestavení, která se instalují pouze na vyžádání. Další informace naleznete v tématu Návod: Stahování sestavení na vyžádání pomocí rozhraní API nasazení ClickOnce pomocí Návrháře. Pokud je nastavena `framework` na a `dependencyType` atribut je nastaven na `prerequisite`, určuje sestavení jako součást rozhraní .NET Framework. Při instalaci na rozhraní .NET Framework 4 a novějších verzí se pro toto sestavení nekontroluje globální mezipaměť sestavení (GAC).
`codeBase`	Požadováno, pokud `dependencyType` je atribut nastaven na `install`. Cesta ke závislému sestavení. Může to být absolutní cesta nebo cesta vzhledem k základu kódu manifestu. Tato cesta musí být platným identifikátorem URI, aby manifest sestavení byl platný.
`size`	Požadováno, pokud `dependencyType` je atribut nastaven na `install`. Velikost závislého sestavení vbajchch

Assemblyidentity

Povinný: Tento prvek je podřízený dependentAssembly prvek a má následující atributy.

Atribut	Popis
`name`	Požadováno. Určuje název aplikace.
`version`	Povinný: Určuje číslo verze aplikace v následujícím formátu: `major.minor.build.revision`
`publicKeyToken`	Nepovinné. Určuje šestnáctkový řetězec 16 znaků, který představuje posledních 8 bajtů `SHA-1` hodnoty hash veřejného klíče, pod kterým je aplikace nebo sestavení podepsána. Veřejný klíč použitý k podepsání katalogu musí být 2048 bitů nebo více.
`processorArchitecture`	Nepovinné. Určuje procesor. Platné hodnoty platí `x86` pro 32bitovou verzi Windows a `I64` pro 64bitovou verzi Windows.
`language`	Nepovinné. Identifikuje dva kódy jazyka, například EN-US, sestavení.

hash

Prvek hash je volitelná podřízená položka elementu assemblyIdentity . Element hash nemá žádné atributy.

ClickOnce používá algoritmus hash všech souborů v aplikaci jako kontrolu zabezpečení, aby se zajistilo, že se po nasazení žádné soubory nezměnily. hash Pokud prvek není součástí, nebude tato kontrola provedena. Proto se nedoporučuje vynechat hash prvek.

dsig:Transforms

Prvek dsig:Transforms je povinný podřízený prvek hash . Element dsig:Transforms nemá žádné atributy.

dsig:Transform

Prvek dsig:Transform je povinný podřízený prvek dsig:Transforms . Element dsig:Transform má následující atributy.

Atribut	Popis
`Algorithm`	Algoritmus použitý k výpočtu hodnoty hash pro tento soubor. V současné době je jediná hodnota používaná technologií ClickOnce `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Prvek dsig:DigestMethod je povinný podřízený prvek hash . Element dsig:DigestMethod má následující atributy.

Atribut	Popis
`Algorithm`	Algoritmus použitý k výpočtu hodnoty hash pro tento soubor. V současné době je jediná hodnota používaná technologií ClickOnce `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Prvek dsig:DigestValue je povinný podřízený prvek hash . Element dsig:DigestValue nemá žádné atributy. Jeho textová hodnota je vypočítaná hodnota hash pro zadaný soubor.

Poznámky

Všechna sestavení používaná vaší aplikací musí mít odpovídající dependency prvek. Závislá sestavení nezahrnují sestavení, která musí být předinstalována v globální mezipaměti sestavení jako sestavení platformy.

Příklad

Následující příklad kódu znázorňuje dependency prvky v manifestu aplikace ClickOnce. Tento příklad kódu je součástí většího příkladu zadaného pro téma manifestu aplikace 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>

Share via