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

Статья
11/16/2008

Обновлен: Ноябрь 2007

Определение атрибутов, используемых для развертывания обновлений и доступа к системе.

<deployment 
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
> 
   <subscription> 
         <update> 
            <beforeApplicationStartup/> 
            <expiration
               maximumAge
               unit
            />
         </update>  
   </subscription> 
   <deploymentProvider 
      codeBase 
   /> 
</deployment>

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

Элемент deployment является обязательным и находится в пространстве имен asmv2. Элемент имеет следующие атрибуты.

Атрибут	Описание
Install	Обязательный атрибут. Указывает, будет ли приложение находиться в меню "Пуск" и в диалоговом окне "Установка и удаление программ" панели управления. Допустимые значения: true и false. Если атрибут имеет значение false, приложение ClickOnce будет всегда запускать последнюю версию приложения из сети и не будет распознавать элемент subscription.
minimumRequiredVersion	Необязательный. Задает минимальный номер версии приложения, запускаемого на клиентском компьютере. Если номер версии приложения меньше, чем номер версии, поддерживаемой в манифесте развертывания, приложение не запустится. Номера версий должны быть указаны в формате N.N.N.N, где N – целое число без знака. Если атрибут install имеет значение false, нельзя задать значение атрибута minimumRequiredVersion.
mapFileExtensions	Необязательный. По умолчанию используется значение false. Если атрибут имеет значение true, все развертываемые файлы должны иметь расширение DEPLOY. Приложение ClickOnce удалит эти расширения сразу после загрузки файлов с веб-сервера. Если приложение опубликовано с помощью Visual Studio, то данное расширение автоматически добавляется ко всем файлам. Этот параметр позволяет загружать все файлы, развертываемые с помощью ClickOnce, с веб-сервера, блокирующего передачу файлов, имеющих небезопасное расширение, например EXE-файлы.
disallowUrlActivation	Необязательный. По умолчанию используется значение false. Установка значения true позволяет предотвратить установку приложения по щелчку URL-адреса или путем ввода URL-адреса в веб-обозреватель Internet Explorer. Если атрибут install отсутствует, то этот атрибут игнорируется.
trustUrlParameters	Необязательный. По умолчанию используется значение false. Установка значения true разрешает URL-адресам содержать параметры строки запроса, передаваемые приложению таким же образом, как аргументы командной строки передаются приложению командной строки. Дополнительные сведения см. в разделе Практическое руководство. Извлечение сведений строки запроса в приложении ClickOnce. Если атрибут disallowUrlActivation имеет значение true, то атрибут trustUrlParameters должен быть либо исключен из манифеста, либо явно установлен в false.

Элемент deployment может содержать следующие дочерние элементы.

subscription

Необязательный. Содержит элемент update. Элемент subscription не имеет атрибутов. Если элемент subscription не существует, то приложение ClickOnce никогда не будет искать обновления. Если атрибут install элемента deployment имеет значение false, элемент subscription игнорируется, т.к. приложение ClickOnce, запускаемое из сети, всегда использует последнюю версию.

update

Обязательный элемент. Этот элемент является дочерним элементом subscription и содержит элемент beforeApplicationStartup или элемент expiration. Элементы beforeApplicationStartup и expiration не могут быть заданы в одном манифесте развертывания.

Элемент update не имеет атрибутов.

beforeApplicationStartup

Необязательный. Этот элемент является дочерним по отношению к элементу update и не имеет атрибутов. Если элемент beforeApplicationStartup существует, то при подключении клиентского компьютера к сети приложение будет блокировать проверки ClickOnce на наличие обновлений. Если элемент не существует, приложение ClickOnce будет проверять наличие обновлений, основываясь на значении, заданном для элемента expiration. Элементы beforeApplicationStartup и expiration не могут быть заданы в одном манифесте развертывания.

expiration

Необязательный. Этот элемент является дочерним по отношению к элементу update и не имеет дочерних элементов. beforeApplicationStartup и expiration не могут задаваться в одном манифесте развертывания.

Элемент expiration поддерживает следующие атрибуты.

Атрибут	Описание
maximumAge	Обязательный атрибут. Указывает давность текущего обновления до того, как приложение выполнит проверку на наличие обновлений. Единица измерения времени задается атрибутом unit.
unit	Обязательный атрибут. Указывает единицу времени для атрибута maximumAge. Допустимыми значениями являются hours, days и weeks.

deploymentProvider

Элемент является обязательным для .NET Framework 2.0, если манифест развертывания содержит раздел subscription; в противном случае – необязателен. Для .NET Framework 3.5 этот элемент является необязательным и указывает путь к серверу и файлу, в котором производится поиск манифеста развертывания.

Этот элемент является дочерним элементом для элемента deployment и имеет следующие атрибуты.

Атрибут	Описание
codeBase	Обязательный. Указывает расположение манифеста развертывания в формате универсального кода ресурса (URI), используемого приложением ClickOnce для выполнения обновления. Этот элемент также позволяет переадресовывать расположение обновлений для установок с компакт-дисков. Должен являться допустимым URI.

codeBase

Обязательный. Указывает расположение манифеста развертывания в формате универсального кода ресурса (URI), используемого приложением ClickOnce для выполнения обновления. Этот элемент также позволяет переадресовывать расположение обновлений для установок с компакт-дисков. Должен являться допустимым URI.

Заметки

Настройку приложения ClickOnce можно выполнить таким образом, чтобы поиск обновлений осуществлялся при запуске, после запуска или не производился вообще. При выборе поиска обновлений при запуске убедитесь, что элемент beforeApplicationStartup находится под элементом update.

При выборе поиска обновлений после запуска убедитесь, что элемент expiration находится под элементом update, и что требуемые интервалы обновления заданы.

Для отмены проверки на наличие обновлений необходимо удалить элемент subscription. При установки в манифесте развертывания отмены проверки наличия обновлений данную проверку можно выполнить вручную с помощью метода CheckForUpdate.

Дополнительные сведения о том, как элемент deploymentProvider связан с обновлениями, см. в разделе Выбор стратегии обновления ClickOnce.

Примеры

В следующем примере кода показан элемент deployment в манифесте развертыванияClickOnce. В примере используется элемент deploymentProvider для указания предпочитаемого расположения обновления. Данный пример кода является частью большого примера, приведенного в разделе ClickOnce Deployment Manifest.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

См. также

Ссылки

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

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