Указание свойств публикации ClickOnce
Свойства публикации ClickOnce можно настроить на странице публикации конструктора проектов или с помощью мастера публикации. В этой статье вы узнаете, как указать такие свойства, как расположение публикации, URL-адрес установки, режим онлайн или автономной установки и версия публикации.
Примечание.
В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии вы устанавливаете свойства развертывания с помощью средства публикации вместо мастера публикации и страницы публикации конструктора проектов. Дополнительные сведения см. в статье "Развертывание приложения .NET Для Windows с помощью ClickOnce и ClickOnce для .NET".
Указание расположения публикации
При публикации приложения с помощью ClickOnce свойство Publish Location указывает расположение, в которое помещены файлы и манифест приложения. Это может быть путь к файлу или путь к FTP-серверу.
Свойство Publish Location можно указать на странице ПубликацияКонструктора проектов или с помощью Мастера публикации. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".
Примечание.
Если вы устанавливаете больше одной версии приложения с использованием технологии ClickOnce, то более ранние версии приложения перемещаются в папку Archive, созданную в указанном вами расположении публикации. Архивация более ранних версий предотвращает появление папок с ранними версиями в каталоге установки.
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
В поле Расположение публикации введите расположение публикации, используя один из следующих форматов:
Чтобы опубликовать общую папку или путь к диску, введите путь с помощью пути UNC (\\Server\ApplicationName) или пути к файлу (C:\Deploy\ApplicationName).
Чтобы опубликовать на FTP-сервере, введите путь с помощью формата ftp://ftp.microsoft.com/ ApplicationName>.<
Обратите внимание, что для работы кнопки обзора (...) в поле Расположение публикации должен присутствовать текст.
указание расположения, из которого будет производиться установка пользователями
При публикации приложения ClickOnce расположение, в котором пользователи отправляются скачать и установить приложение, не обязательно расположение, в котором изначально публикуется приложение. Например, в некоторых организациях разработчик может опубликовать приложение на промежуточном сервере, а затем администратор переместит приложение на веб-сервер.
В этом случае свойство можно использовать Installation URL для указания веб-сервера, на котором пользователи будут отправляться для скачивания приложения. Это необходимо, чтобы манифест приложения знал, где искать обновления.
Свойство Installation URL можно задать на странице публикации конструктора проектов.
Примечание.
Свойство Installation URL также можно задать с помощью PublishWizard. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".
Указание URL-адреса установки
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
В поле "URL-адрес установки" введите расположение установки с помощью полного URL-адреса с помощью формата
https://www.contoso.com/ApplicationNameили UNC-пути с использованием формата\Server\ApplicationName.
задание режима установки ClickOnce: автономного или через Интернет
Приложение Install Mode ClickOnce определяет, будет ли приложение доступно в автономном режиме или в сети. При выборе приложения доступен только в Интернете, пользователь должен иметь доступ к расположению публикации ClickOnce (веб-странице или общей папке), чтобы запустить приложение. Если выбрать приложение доступно в автономном режиме, приложение добавляет записи в меню "Пуск " и диалоговое окно "Добавление или удаление программ "; пользователь может запустить приложение, если они не подключены.
Его Install Mode можно задать на странице публикации конструктора проектов.
Примечание.
Его Install Mode также можно задать с помощью мастера публикации. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".
Сделать приложение ClickOnce доступным только в Интернете
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
В области "Режим установки" и "Параметры" нажмите кнопку "Приложение доступно только в сети".
Сделать приложение ClickOnce доступным в сети или в автономном режиме
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
В области "Режим установки" и "Параметры" нажмите кнопку "Приложение доступно в автономном режиме".
При установке приложение добавляет записи в меню "Пуск" и "Добавить или удалить программы" в панель управления.
установку версии публикации приложения ClickOnce
Свойство ClickOnce Publish Version определяет, будет ли приложение, которое вы публикуете, рассматриваться как обновление. Каждый раз, когда версия увеличивается, приложение будет опубликовано как обновление.
Свойство Publish Version можно задать на странице публикации конструктора проектов.
Примечание.
Существует параметр проекта, который автоматически Publish Version увеличивает свойство при каждом публикации приложения. Этот параметр включен по умолчанию. Дополнительные сведения см. в статье "Автоматическое увеличение версии публикации ClickOnce".
Изменение версии публикации
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
В поле "Публикация версии" добавим номера версий основного, дополнительного, сборки или редакции.
Примечание.
Вы никогда не должны уменьшать номер версии; это может привести к непредсказуемому поведению обновлений.
Автоматическое увеличение номера версии публикации ClickOnce
При публикации приложения ClickOnce изменение Publish Version свойства приводит к публикации приложения в качестве обновления. По умолчанию Visual Studio автоматически увеличивает Revision число Publish Version каждый раз при публикации приложения.
Это поведение можно отключить на странице публикации конструктора проектов.
Примечание.
В зависимости от установок или выпуска сервера доступные диалоговые окна и команды меню могут отличаться от описанных в справке. Чтобы изменить параметры, выберите Импорт и экспорт параметров в меню Сервис . Дополнительные сведения см. в разделе Сброс параметров.
Отключение автоматического увеличения версии публикации
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
В разделе "Публикация версии" снимите флажок "Автоматически увеличиваться" с помощью каждого флажка выпуска.
Задание страницы публикации для приложения ClickOnce
При публикации приложения ClickOnce создается и публикуется веб-страница по умолчанию (publish.htm). Эта страница содержит имя приложения, ссылку на установку приложения и (или) необходимых компонентов, а также ссылку на раздел справки, описывающий ClickOnce. Свойство "Публикация страницы " для проекта позволяет указать имя веб-страницы для приложения ClickOnce.
После указания страницы публикации при следующей публикации она будет скопирована в расположение публикации; Он не будет перезаписан при повторной публикации. Если вы хотите настроить внешний вид страницы, это можно сделать, не беспокоясь о потере изменений. Дополнительные сведения см. в разделе "Настройка веб-страницы ClickOnce по умолчанию".
Свойство "Публикация страницы" можно задать в диалоговом окне "Параметры публикации", доступное в области "Публикация" конструктора проектов.
Чтобы указать настраиваемую веб-страницу для приложения ClickOnce, выполните указанные действия.
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Выберите область публикации.
Нажмите кнопку "Параметры", чтобы открыть диалоговое окно "Параметры публикации".
Щелкните Развертывание.
В диалоговом окне "Параметры публикации" убедитесь, что веб-страница "Открыть развертывание" после выбора флажка публикации (она должна быть выбрана по умолчанию).
В поле веб-страницы развертывания введите имя веб-страницы и нажмите кнопку "ОК".
Чтобы предотвратить запуск страницы публикации при каждом публикации:
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Выберите область публикации.
Нажмите кнопку "Параметры", чтобы открыть диалоговое окно "Параметры публикации".
Щелкните Развертывание.
В диалоговом окне "Параметры публикации" снимите флажок "Открыть развертывание" после публикации.
Настройка используемой по умолчанию веб-страницы для приложения ClickOnce
При публикации приложения ClickOnce в Интернете веб-страница автоматически создается и публикуется вместе с приложением. Страница по умолчанию содержит имя приложения и ссылки на установку приложения, установку необходимых компонентов или справку по доступу в MSDN.
Примечание.
Фактические ссылки, отображаемые на странице, зависят от компьютера, где просматривается страница и какие необходимые условия вы включаете.
Имя веб-страницы по умолчанию — Publish.htm; можно изменить имя в конструкторе проектов. Дополнительные сведения см. в разделе "Указание страницы публикации" для приложения ClickOnce.
Веб-страница Publish.htm публикуется только в том случае, если обнаружена более новая версия.
Примечание.
Изменения, внесенные в параметры публикации , не влияют на страницу Publish.htm , за исключением одного исключения: при добавлении или удалении необходимых компонентов после первоначальной публикации список предварительных требований больше не будет точным. Чтобы отразить изменения, необходимо изменить текст для ссылки на предварительные требования.
Чтобы настроить веб-страницу публикации, выполните следующие действия.
Опубликуйте приложение ClickOnce в веб-расположении. Дополнительные сведения см. в статье "Практическое руководство. Публикация приложения ClickOnce с помощью мастера публикации".
На веб-сервере откройте файл Publish.htm в Visual Web Designer или другой редактор HTML.
Настройте страницу по желанию и сохраните ее.
Необязательно. Чтобы предотвратить перезапись настраиваемой веб-страницы публикации Visual Studio, снимите флажок "Автоматически создать веб-страницу развертывания" после каждой публикации в диалоговом окне "Параметры публикации".
задание ссылки на веб-страницу технической поддержки
При публикации приложения ClickOnce свойство URL-адреса поддержки определяет веб-страницу или общую папку, где пользователи могут получать сведения о приложении. Это свойство является необязательным; При указании URL-адрес будет отображаться в диалоговом окне " Добавление или удаление программ" приложения.
Свойство URL-адреса поддержки можно задать на странице публикации конструктора проектов.
Чтобы указать URL-адрес поддержки, выполните указанные действия.
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
Нажмите кнопку "Параметры", чтобы открыть диалоговое окно "Параметры публикации".
Нажмите кнопку " Описание".
В поле 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-адреса поддержки для отдельного обязательного условия
Откройте манифест приложения ( файл манифеста ) для приложения ClickOnce в текстовом редакторе.
Для предварительного требования операционной системы добавьте атрибут в
supportUrldependentOSэлемент:<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>Для выполнения определенной версии среды CLR добавьте
supportUrlатрибутdependentAssemblyв запись, указывающую зависимость среды CLR:<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>Для предварительно установленной сборки в глобальном кэше сборок задайте
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>Необязательно. Для приложений, предназначенных для платформа .NET Framework 4, откройте манифест развертывания (файл приложения) для приложения ClickOnce в текстовом редакторе.
Для платформа .NET Framework 4 необходимо добавить атрибут в
supportUrlcompatibleFrameworksэлемент:<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>После изменения манифеста приложения вручную необходимо повторно подписать манифест приложения с помощью цифрового сертификата, а затем обновить и повторно подписать манифест развертывания. Используйте средства пакета SDK Mage.exe или MageUI.exe для выполнения этой задачи, так как повторное создание этих файлов с помощью Visual Studio удаляет изменения вручную. Дополнительные сведения об использовании Mage.exe для повторного подписывания манифестов см. в статье "Практическое руководство. Повторная регистрация манифестов приложения и развертывания".
безопасность платформы .NET Framework
URL-адрес поддержки не отображается в диалоговом окне, если приложение помечено для запуска в частичном доверии.
Изменение языка публикации для приложения ClickOnce
При публикации приложения ClickOnce пользовательский интерфейс, отображаемый во время установки по умолчанию для языка и языка и региональных параметров компьютера разработки. Если вы публикуете локализованное приложение, необходимо указать язык и язык и региональные параметры для сопоставления локализованной версии. Это определяется свойством Publish language проекта.
Свойство Publish language можно задать в диалоговом окне "Параметры публикации", доступное на странице публикации конструктора проектов.
Примечание.
В зависимости от установок или выпуска сервера доступные диалоговые окна и команды меню могут отличаться от описанных в справке. Чтобы изменить параметры, выберите Импорт и экспорт параметров в меню Сервис . Дополнительные сведения см. в разделе Сброс параметров.
Чтобы изменить язык публикации, выполните следующие действия.
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
Примечание.
В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии вы устанавливаете свойства развертывания с помощью средства публикации вместо мастера публикации и страницы публикации конструктора проектов. Дополнительные сведения см. в статье "Развертывание приложения .NET Для Windows с помощью ClickOnce и ClickOnce для .NET".
Нажмите кнопку "Параметры", чтобы открыть диалоговое окно "Параметры публикации".
Нажмите кнопку " Описание".
В диалоговом окне "Параметры публикации" выберите язык и региональные параметры в раскрывающемся списке "Публикация языка" и нажмите кнопку "ОК".
Задание имени в меню "Пуск" для приложения ClickOnce
Если приложение ClickOnce установлено как для работы в сети, так и в автономном режиме, запись добавляется в меню "Пуск " и в списке "Добавить или удалить программы ". По умолчанию отображаемое имя совпадает с именем сборки приложения, но вы можете изменить отображаемое имя, задав имя продукта в диалоговом окне "Параметры публикации".
Имя продукта будет отображаться на странице publish.htm; для установленного автономного приложения оно будет именем записи в меню "Пуск", а также будет именем, отображаемым в разделе "Добавление или удаление программ".
Имя издателя появится на странице publish.htm выше имени продукта, а для установленного автономного приложения также будет именем папки, содержащей значок приложения в меню "Пуск ".
Ярлык меню или ссылка на приложение создается в папке %appdata%\Microsoft\Windows\Start Menu\Program\<Publisher>. Ссылка на ярлык или приложение имеет то же имя, что и имя продукта.
Свойства имени продукта и издателя можно задать в диалоговом окне "Параметры публикации", доступном на странице публикации конструктора проектов.
Чтобы указать имя меню , выполните указанные действия.
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
Нажмите кнопку "Параметры", чтобы открыть диалоговое окно "Параметры публикации".
Нажмите кнопку " Описание".
В диалоговом окне " Параметры публикации" введите имя, отображаемое в имени продукта.
При необходимости можно ввести имя издателя в имени издателя.
включение автозапуска при установке с компакт-диска
При развертывании приложения ClickOnce с помощью съемных носителей, таких как КОМПАКТ-ДИСК или DVD-ДИСК, можно включить AutoStart , чтобы приложение ClickOnce автоматически запускалось при вставке носителя.
AutoStartможно включить на странице публикации конструктора проектов.
Чтобы включить автозапуск:
Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.
Перейдите на вкладку Публикация.
Нажмите кнопку Параметры .
Откроется диалоговое окно "Параметры публикации ".
Щелкните Развертывание.
Установите флажок "Для установки компакт-дисков", автоматически запустите программу установки при вставке компакт-диска.
Файл Autorun.inf будет скопирован в расположение публикации при публикации приложения.