Поделиться через

Элемент <dependency> (развертывание ClickOnce)

  • Статья

Определяет версию устанавливаемого приложения и расположение манифеста приложения.

<dependency> 
   <dependentAssembly
      preRequisite
      visible
      dependencyType
      codeBase
      size
   > 
      <assemblyIdentity 
         name 
         version 
         publicKeyToken 
         processorArchitecture 
         language
         type
      /> 
      <hash>
         <dsig:Transforms>
            <dsig:Transform
                Algorithm
            />
         </dsig:Transforms>
         <dsig:DigestMethod />
         <dsig:DigestValue>
         </dsig:DigestValue>
      </hash>

   </dependentAssembly> 
</dependency>

Элементы и атрибуты

Элемент dependency является обязательным. В нем нет атрибутов. Манифест развертывания может иметь несколько элементов dependency.

Элемент dependency обычно выражает зависимости для главного приложения от сборок, содержащихся в приложении ClickOnce. Если приложение Main.exe включает сборку DotNetAssembly.dll, то эта сборка должна быть указана в разделе зависимостей. Однако зависимость может также выражать другие типы зависимостей, например зависимости от определенной версии среды CLR, от сборки в глобальном кэше сборок (GAC) или от объекта COM. Поскольку эта технология развертывания "без вмешательства", ClickOnce не может инициировать загрузку и установку этих типов зависимостей, но предотвращает запуск приложения в случае, когда одна или несколько указанных зависимостей не существуют.

dependentAssembly

Обязательный. Этот элемент содержит элемент assemblyIdentity. В следующей таблице перечислены атрибуты, поддерживаемые элементом dependentAssembly.

Атрибут

Описание

preRequisite

Необязательный. Указание того, что данная сборка уже должна присутствовать в GAC. Допустимые значения: true и false. Если присвоено значение true и указанная сбор отсутствует в GAC, запуск приложения невозможен.

visible

Необязательный. Определение удостоверения приложения верхнего уровня, включая его зависимости. Предназначен для внутреннего использования в ClickOnce для управления хранением и активацией приложений.

dependencyType

Обязательный. Связь между зависимостью и приложением. Допустимые значения:

  • install. Компонент обозначает установку отдельно от текущего приложения.

  • preRequisite. Компонент необходим текущему приложению.

codebase

Необязательный. Полный путь к манифесту приложения.

size

Необязательный. Размер манифеста приложения в байтах.

assemblyIdentity

Обязательный. Этот элемент является дочерним для элемента dependentAssembly. Содержимое assemblyIdentity должно совпадать с описанием в манифесте приложения ClickOnce. В следующей таблице перечислены атрибуты элемента assemblyIdentity.

Атрибут

Описание

Name

Обязательный. Идентифицирует имя приложения.

Version

Обязательный. Указание номера версии приложения в следующем формате: старший разряд.младший разряд.построение.редакция

publicKeyToken

Обязательный. Задание 16-символьной шестнадцатеричной строки, которая представляет последние 8 байтов хэша SHA-1 открытого ключа, которым приложение или сборка подписывается. Открытый ключ доступа, используемый для подписи, должен иметь длину не менее 2048 бит.

processorArchitecture

Обязательный. Указание микропроцессора. Действующие значения x86 для 32-битового Windows и IA64 для 64-битового Windows.

Language

Необязательный. Определение двух частей кодов языка сборки. Например, EN-US для "Английский (США)". По умолчанию используется значение neutral. Этот элемент находится в пространстве имен asmv2.

type

Необязательный. Для обратной совместимости с технологией параллельной установки Windows. Единственным допустимым значением является win32.

hash

Элемент hash является необязательным дочерним элементом элемента file. У элемента hash отсутствуют атрибуты.

Чтобы гарантировать, что ни один из файлов не был изменен после развертывания, ClickOnce использует алгоритмический хэш всех файлов в приложении. Если элемент hash не включен, такая проверка выполняться не будет. Поэтому не рекомендуется пропускать элемент hash.

dsig:Transforms

Элемент dsig:Transforms является обязательным дочерним элементом элемента hash. У элемента dsig:Transforms отсутствуют атрибуты.

dsig:Transform

Элемент dsig:Transform является обязательным дочерним элементом элемента dsig:Transforms. В следующей таблице отображены атрибуты элемента dsig:Transform.

Атрибут

Описание

Algorithm

Алгоритм, используемый для вычисления дайджеста для этого файла. В настоящее время значением, используемым ClickOnce, может быть только urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Элемент dsig:DigestMethod является обязательным дочерним элементом элемента hash. В следующей таблице отображены атрибуты элемента dsig:DigestMethod.

Атрибут

Описание

Algorithm

Алгоритм, используемый для вычисления дайджеста для этого файла. В настоящее время ClickOnce может использовать только значение http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

Элемент dsig:DigestValue является обязательным дочерним элементом элемента hash. У элемента dsig:DigestValue отсутствуют атрибуты. Его текстовое значение – это вычисленный хэш для указанного файла.

Заметки

Обычно манифест развертывания имеет один элемент assemblyIdentity, идентифицирующий имя и версию манифеста приложения.

Пример

В следующем примере кода показан элемент dependency в манифесте развертывания ClickOnce.

<!-- Identify the assembly dependencies -->
<dependency>
  <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="MyApplication.exe" size="16384">
    <assemblyIdentity name="MyApplication" version="0.0.0.0" cultural="neutral" processorArchitecture="msil" />
    <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>YzXYZJAvj9pgAG3y8jXUjC7AtHg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

В следующем примере кода указывается зависимость от сборки, уже установленной в GAC.

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="GACAssembly" version="1.0.0.0" language="neutral" processorArchitecture="msil" />
  </dependentAssembly>
</dependency>

В следующем примере кода указывается зависимость от определенной версии среды CLR.

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.50215.0" />
  </dependentAssembly>
</dependency>

В следующем примере кода указывается зависимость от операционной системы.

<dependency>
   <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
      <osVersionInfo>
         <os majorVersion="4" minorVersion="10" />
      </osVersionInfo>
   </dependentOS>
</dependency>

См. также

Ссылки

Манифест развертывания ClickOnce

Элемент <dependency> (приложение ClickOnce)