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

Задайте свойства публикации ClickOnce

Свойства публикации ClickOnce можно настроить на странице публикацииконструктора проектов или с помощью мастера публикации. В этой статье вы узнаете, как указать такие свойства, как расположение публикации, URL-адрес установки, режим онлайн или автономной установки и версия публикации.

Замечание

В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии вы устанавливаете свойства развертывания с помощью средства публикации вместо мастера публикации и страницы публикации конструктора проектов. Дополнительные сведения см. в статьях "Развертывание приложения .NET для Windows с помощью ClickOnce" и "ClickOnce для .NET".

Указание расположения публикации

При публикации приложения с помощью ClickOnce Publish Location свойство указывает расположение, в котором помещаются файлы приложения и манифест. Это может быть путь к диску (), общую папку (C:\deploy\myapplication\\server\myapplication) или FTP-сервер (ftp://ftp.microsoft.com/myapplication). Обратите внимание, что текст должен присутствовать в поле "Расположение публикации ", чтобы кнопка обзора (...) работала.

Свойство можно указать Publish Location на странице публикацииконструктора проектов или с помощью мастера публикации. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".

Замечание

При установке нескольких версий приложения с помощью ClickOnce установка перемещает более ранние версии приложения в папку с именем Archive в указанном расположении публикации. Архивация более ранних версий таким образом сохраняет каталог установки без папок из более ранней версии.

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. В поле "Расположение публикации " введите расположение публикации с помощью одного из следующих форматов:

    • Чтобы опубликовать общую папку или путь к диску, введите путь с помощью пути UNC (\\Server\ApplicationName) или пути к файлу (C:\Deploy\ApplicationName).

    • Чтобы опубликовать на FTP-сервере, введите путь с помощью формата ftp://ftp.microsoft.com/<ApplicationName>.

      Обратите внимание, что текст должен присутствовать в поле "Расположение публикации ", чтобы кнопка обзора (...) работала.

Укажите местоположение, из которого конечные пользователи будут выполнять установку.

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

В этом случае свойство Installation URL можно использовать для указания веб-сервера, на который пользователи будут переходить для скачивания приложения. Это необходимо, чтобы манифест приложения знал, где искать обновления.

Свойство Installation URL можно задать на странице публикацииконструктора проектов.

Замечание

Свойство Installation URL также можно задать с помощью PublishWizard. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".

Указание URL-адреса установки

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. В поле "URL-адрес установки" введите расположение установки, используя полный URL-адрес в формате https://www.contoso.com/ApplicationName, или UNC-путь в формате \Server\ApplicationName.

Укажите режим установки ClickOnce в автономном режиме или в сети

Ключевой параметр Install Mode для приложения ClickOnce определяет, будет ли оно доступно в автономном или онлайн-режиме. При выборе приложение доступно только в Интернете, пользователь должен иметь доступ к месту публикации ClickOnce (веб-странице или сетевой папке), чтобы запустить приложение. Если выбрать приложение доступно в автономном режиме, то приложение добавляет записи в меню «Пуск» и в диалоговое окно «Добавить или удалить программы». Пользователь может запустить приложение, когда он не подключён.

Установить Install Mode можно на странице Публикации в Конструкторе проектов.

Замечание

Элемент Install Mode также можно задать с помощью мастера публикации. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".

Сделать приложение ClickOnce доступным только в Интернете

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. В области "Режим установки" и "Параметры " нажмите кнопку "Приложение доступно только в сети ".

Сделать приложение ClickOnce доступным в сети или в автономном режиме

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. В области "Режим установки" и "Параметры " нажмите кнопку " Приложение доступно в автономном режиме ".

    При установке приложение добавляет записи в меню "Пуск " и " Добавить или удалить программы " на панели управления.

Настройка версии публикации ClickOnce

Свойство ClickOnce Publish Version определяет, будет ли приложение, которое вы публикуете, рассматриваться как обновление. Каждый раз, когда версия увеличивается, приложение будет опубликовано как обновление.

Свойство Publish Version можно задать на странице публикацииконструктора проектов.

При изменении номера версии приложение публикуется как обновление. Каждая часть версии публикации (основной, дополнительный, сборка, редакция) может иметь максимальное значение 65535 (MaxValue), максимально допустимое.Version

При установке нескольких версий приложения с помощью ClickOnce установка перемещает более ранние версии приложения в папку с именем Archive в указанном расположении публикации. Архивация более ранних версий таким образом сохраняет каталог установки без папок из более ранней версии.

Замечание

Существует параметр проекта, который автоматически увеличивает значение свойства Publish Version при каждой публикации приложения; этот параметр включен по умолчанию. Дополнительные сведения см. в статье "Автоматическое увеличение версии публикации ClickOnce".

Изменение версии публикации

  1. При выборе проекта в обозревателе решений в меню "Проект " выберите пункт "Свойства".

  2. Щелкните вкладку "Опубликовать ".

  3. В поле "Публикация версии" увеличьте номера версий основного, дополнительного, сборки или редакции.

    Замечание

    Вы никогда не должны уменьшать номер версии; это может привести к непредсказуемому поведению обновлений.

Автоматическое увеличение версии публикации ClickOnce

При публикации приложения ClickOnce изменение Publish Version свойства приводит к публикации приложения в качестве обновления. По умолчанию Visual Studio автоматически увеличивает Revision номер Publish Version каждый раз, когда вы публикуете приложение.

Это поведение можно отключить на странице публикацииконструктора проектов.

Замечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от ваших текущих параметров или используемой редакции. Чтобы изменить параметры, выберите "Импорт и экспорт параметров" в меню "Инструменты". Дополнительные сведения см. в разделе Сброс параметров.

Отключение автоматического увеличения версии публикации

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. В разделе Публикация версии снимите флажок Автоматически увеличивать ревизию с каждым выпуском.

Указание страницы публикации для приложения ClickOnce

При публикации приложения ClickOnce создается и публикуется веб-страница по умолчанию (publish.htm) вместе с приложением. Эта страница содержит имя приложения, ссылку на установку приложения и (или) необходимых компонентов, а также ссылку на раздел справки, описывающий ClickOnce. Свойство "Публикация страницы " для проекта позволяет указать имя веб-страницы для приложения ClickOnce.

После указания страницы публикации при следующей публикации её копия будет сохранена в указанном месте, и при повторной публикации она не будет перезаписана. Если вы хотите настроить внешний вид страницы, это можно сделать, не беспокоясь о потере изменений. Дополнительные сведения см. в разделе "Настройка веб-страницы ClickOnce по умолчанию".

Свойство "Публикация страницы" можно задать в диалоговом окне "Параметры публикации ", доступное в области "Публикация " конструктора проектов.

Чтобы указать настраиваемую веб-страницу для приложения ClickOnce, выполните указанные действия.

  1. При выборе проекта в обозревателе решений в меню "Проект " выберите пункт "Свойства".

  2. Выберите область публикации .

  3. Нажмите кнопку "Параметры" , чтобы открыть диалоговое окно "Параметры публикации ".

  4. Щелкните "Развертывание".

  5. В диалоговом окне Параметры публикации убедитесь, что установлен флажок Открыть веб-страницу развертывания после публикации (он должен быть установлен по умолчанию).

  6. В поле веб-страницы развертывания введите имя веб-страницы и нажмите кнопку "ОК".

Чтобы предотвратить запуск страницы публикации при каждой публикации:

  1. При выборе проекта в обозревателе решений в меню "Проект " выберите пункт "Свойства".

  2. Выберите область публикации .

  3. Нажмите кнопку "Параметры" , чтобы открыть диалоговое окно "Параметры публикации ".

  4. Щелкните "Развертывание".

  5. В диалоговом окне «Параметры публикации» снимите флажок «Открыть веб-страницу развертывания после публикации».

Настройка веб-страницы по умолчанию для приложения ClickOnce

При публикации приложения ClickOnce в Интернете веб-страница автоматически создается и публикуется вместе с приложением. Страница по умолчанию содержит имя приложения и ссылки на установку приложения, установку необходимых компонентов или справку по доступу в MSDN.

Замечание

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

Имя веб-страницы по умолчанию — Publish.htm; имя можно изменить в конструкторе проектов. Дополнительные сведения см. в разделе "Указание страницы публикации" для приложения ClickOnce.

Веб-страница Publish.htm публикуется только в том случае, если обнаружена более новая версия.

Замечание

Изменения, внесенные в параметры публикации , не влияют на страницу Publish.htm , за исключением одного исключения: при добавлении или удалении необходимых компонентов после первоначальной публикации список предварительных требований больше не будет точным. Чтобы отразить изменения, необходимо изменить текст для ссылки на предварительные требования.

Чтобы настроить веб-страницу публикации, выполните следующие действия.

  1. Опубликуйте приложение ClickOnce в веб-среде. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".

  2. На веб-сервере откройте файлPublish.htm в Visual Web Designer или другой редактор HTML.

  3. Настройте страницу по желанию и сохраните ее.

  4. Необязательно. Чтобы Visual Studio не перезаписывала вашу настроенную веб-страницу публикации, снимите флажок Автоматически создавать веб-страницу развертывания после каждой публикации в диалоговом окне Параметры публикации.

При публикации приложения ClickOnce свойство URL-адреса поддержки определяет веб-страницу или общую папку, где пользователи могут получать сведения о приложении. Это свойство является необязательным; При указании URL-адрес будет отображаться в диалоговом окне "Добавление или удаление программ" приложения.

Свойство URL-адреса поддержки можно задать на странице публикацииконструктора проектов.

Чтобы указать URL-адрес поддержки, выполните указанные действия.

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. Нажмите кнопку "Параметры" , чтобы открыть диалоговое окно "Параметры публикации ".

  4. Нажмите кнопку "Описание".

  5. В поле URL-адрес поддержки введите полный квалифицированный путь к веб-сайту, веб-странице или сетевой папке UNC.

Укажите URL-адрес поддержки для отдельных предварительных требований в развертывании ClickOnce

Развертывание ClickOnce может протестировать ряд предварительных требований, которые должны быть доступны на клиентском компьютере для запуска приложения ClickOnce. Эти зависимости включают требуемую минимальную версию .NET Framework, версию операционной системы и все сборки, которые должны быть предварительно установлены в глобальном кэше сборок (GAC). Однако ClickOnce не может установить ни одного из этих предварительных требований; Если предварительные требования не найдены, он просто останавливает установку и отображает диалоговое окно, объясняющее, почему установка завершилась ошибкой.

Существует два метода установки предварительных требований. Их можно установить с помощью приложения начальной загрузки. Кроме того, можно указать URL-адрес поддержки для отдельных предварительных требований, который отображается пользователям в диалоговом окне, если предварительные требования не найдены. Страница, на которую ссылается этот URL-адрес, может содержать ссылки на инструкции по установке необходимого требования. Если приложение не указывает URL-адрес поддержки для отдельного обязательного условия, ClickOnce отображает URL-адрес поддержки, указанный в манифесте развертывания для приложения в целом, если он определен.

Хотя Visual Studio, Mage.exe и MageUI.exe можно использовать для создания развертываний ClickOnce, ни одно из этих средств не поддерживает возможность указания URL-адреса поддержки для отдельных предварительных требований. В этом документе описывается, как изменить манифест приложения развертывания и манифест развертывания, чтобы включать в себя эти URL-адреса поддержки.

Замечание

В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии вы устанавливаете свойства развертывания с помощью средства публикации вместо мастера публикации и страницы публикации конструктора проектов. Дополнительные сведения см. в статьях "Развертывание приложения .NET для Windows с помощью ClickOnce" и "ClickOnce для .NET".

Указание URL-адреса поддержки для отдельного обязательного условия

  1. Откройте манифест приложения ( файл манифеста ) для приложения ClickOnce в текстовом редакторе.

  2. Для предварительного условия операционной системы добавьте атрибут supportUrl к элементу dependentOS.

     <dependency>
    <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
      <osVersionInfo>
        <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

  3. Для указания предварительного условия для определенной версии общей языковой среды выполнения, добавьте атрибут supportUrl в запись dependentAssembly, указывающую зависимость от общей языковой среды выполнения.

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

  4. Для условия предварительной установки сборки в глобальном кэше сборок, задайте supportUrl для элемента dependentAssembly, который указывает требуемую сборку.

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
      <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
    </dependentAssembly>
  </dependency>

  5. Необязательно. Для приложений, предназначенных для .NET Framework 4, откройте манифест развертывания ( файл приложения ) для приложения ClickOnce в текстовом редакторе.

  6. Для предполагаемого требования .NET Framework 4 добавьте атрибут supportUrl в элемент compatibleFrameworks:

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

  7. После изменения манифеста приложения вручную необходимо повторно подписать манифест приложения с помощью цифрового сертификата, а затем обновить и повторно подписать манифест развертывания. Используйте средства пакета SDK Mage.exe или MageUI.exe для выполнения этой задачи, так как повторное создание этих файлов с помощью Visual Studio удаляет изменения вручную. Дополнительные сведения об использовании Mage.exe для повторного подписывания манифестов см. в статье "Практическое руководство. Повторная регистрация манифестов приложения и развертывания".

безопасность платформы .NET Framework

URL-адрес поддержки не отображается в диалоговом окне, если приложение настроено на запуск с ограниченными правами.

Замечание

В ClickOnce для .NET Core и .NET 5 или более поздней версии частичное доверие, для которого требуется безопасность доступа к коду, не поддерживается. В .NET Framework использование безопасности доступа к коду не является передовой практикой и не рекомендуется.

Изменение языка публикации для приложения ClickOnce

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

Свойство Publish language можно задать в диалоговом окне "Параметры публикации ", доступное на странице публикацииконструктора проектов.

Замечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от ваших текущих параметров или используемой редакции. Чтобы изменить параметры, выберите "Импорт и экспорт параметров" в меню "Инструменты". Дополнительные сведения см. в разделе Сброс параметров.

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

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

    Замечание

    В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии вы устанавливаете свойства развертывания с помощью средства публикации вместо мастера публикации и страницы публикации конструктора проектов. Дополнительные сведения см. в статьях "Развертывание приложения .NET для Windows с помощью ClickOnce" и "ClickOnce для .NET".

  3. Нажмите кнопку "Параметры" , чтобы открыть диалоговое окно "Параметры публикации ".

  4. Нажмите кнопку "Описание".

  5. В диалоговом окне "Параметры публикации " выберите язык и региональные параметры в раскрывающемся списке " Публикация языка " и нажмите кнопку "ОК".

Указание имени меню "Пуск" для приложения ClickOnce

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

Имя продукта будет отображаться на странице publish.htm ; для установленного автономного приложения это будет имя записи в меню "Пуск ", а также имя, отображаемое в разделе "Добавление или удаление программ".

Имя издателя появится на странице publish.htm над именем продукта, а для установленного автономного приложения также будет именем папки, содержащей значок приложения в меню "Пуск ".

Ярлык меню Пуск или ссылка на приложение создается в %appdata%\Microsoft\Windows\Start Menu\Programs\<имя издателя>. Ссылка на ярлык или приложение имеет то же имя, что и имя продукта.

Свойства имени продукта и издателя можно задать в диалоговом окне "Параметры публикации ", доступном на странице публикацииконструктора проектов.

Чтобы указать имя меню "Пуск", выполните указанные действия.

  1. При выборе проекта в обозревателе решений в меню Проект щелкните Свойства.

  2. Щелкните вкладку "Опубликовать ".

  3. Нажмите кнопку "Параметры" , чтобы открыть диалоговое окно "Параметры публикации ".

  4. Нажмите кнопку "Описание".

  5. В диалоговом окне "Параметры публикации " введите имя, отображаемое в имени продукта.

  6. При необходимости можно ввести имя издателя в имени издателя.

Включение автоматического запуска для установок CD

При развертывании приложения ClickOnce с помощью съемных носителей, таких как CD-ROM или DVD-ДИСК, можно включить AutoStart , чтобы приложение ClickOnce автоматически запускалось при вставке носителя.

AutoStart можно включить на странице публикацииконструктора проектов.

Чтобы включить автозапуск:

  1. При выборе проекта в обозревателе решений в меню "Проект " выберите пункт "Свойства".

  2. Щелкните вкладку "Опубликовать ".

  3. Нажмите кнопку Параметры .

    Откроется диалоговое окно "Параметры публикации ".

  4. Щелкните "Развертывание".

  5. Установите флажок "Для установки компакт-дисков", автоматически запустите программу установки при вставке компакт-диска .

    Файл Autorun.inf будет скопирован в каталог публикации при публикации приложения.

Связанный контент