Задача GenerateDeploymentManifest
Создает ClickOnce манифест развертывания. Манифест развертывания ClickOnce описывает развертывание приложения, определяя уникальное удостоверение для развертывания, идентифицируя признаки развертывания, например установка или режим онлайн, задавая параметры обновления приложения и расположения обновления и указывая соответствующий манифест приложения ClickOnce.
Параметры
В следующей таблице описаны параметры задачи GenerateDeploymentManifest.
Параметр |
Описание |
|---|---|
AssemblyName |
Необязательный параметр типа String. Задает поле Name удостоверения сборки для создаваемого манифеста. Если этот параметр не задан, то имя выводится из параметра EntryPoint или InputManifest. Если имя невозможно вывести, то задача сообщает об ошибке. |
AssemblyVersion |
Необязательный параметр типа String. Поле Version удостоверения сборки для создаваемого манифеста. Если этот параметр не задан, то задача использует значение "1.0.0.0". |
CreateDesktopShortcut |
Необязательный параметр типа Boolean. Если true, на рабочем столе создается значок при установке приложения ClickOnce. |
DeploymentUrl |
Необязательный параметр типа String. Задает место обновления приложения. Если этот параметр не задан, то для приложения не определено никакого расположения обновления. Однако, параметр UpdateEnabled это true, то расположение обновления должно быть указано. Указанное значение должно представлять собой полный URL-адрес или UNC-путь. |
Description |
Необязательный параметр типа String. Указывает необязательное описание приложения. |
DisallowUrlActivation |
Необязательный параметр типа Boolean. Определяет, должно ли приложение выполняться автоматически, когда оно открывается через URL. Если значение этого параметра true, то приложение можно запускать только из меню Пуск. По умолчанию этот параметр имеет значение false. Этот вход применяется, только когда значение параметра Install равно true. |
EntryPoint |
Необязательный параметр ITaskItem[] . Указывает точку входа для создаваемой сборки манифеста. Для манифеста развертывания ClickOnce этот ввод указывает манифест приложения ClickOnce. В Visual Studio 2005 требуется Задача GenerateApplicationManifest ссылка EntryPoint, чтобы создать манифест приложения. (Сборка или собственный манифест не требует EntryPoint.) Это требование было предписано ошибкой построения: "MSB3185: Не указана EntryPoint для манифеста". Средство MSBuild не выводит эту ошибку, если не задан параметр задачи EntryPoint. Вместо этого <customHostSpecified> тег вставляется в качестве дочернего элемента для тега <точки входа>, например: <entryPoint xmlns="urn:schemas- microsoft-com:asm.v2"> <co.v1:customHostSpecified /> </entryPoint> Можно добавить зависимости DLL в манифест приложения, используя следующие шаги:
|
ErrorReportUrl |
Необязательный параметр типа [String]. задает URL-адрес веб-страницы, который отображается в диалоговых окнах во время установки ClickOnce. |
InputManifest |
Необязательный параметр типа ITaskItem. Входной XML-документ, на основе которого создается манифест. Это позволяет структурным данным, например пользовательским определениям манифеста, отражаться в результате манифеста. Корневой элемент в XML-документе должен быть узлом сборки в пространстве имен asmv1. |
Install |
Необязательный параметр типа Boolean. Определяет, является ли приложение установленным приложением или только интерактивным приложением. Если значение этого параметра true, то приложение будет установлено в пользовательском меню Пуск и его нельзя удалить, используя диалоговое окно Установка или удаление программ. Если значение этого параметра false, то приложение предназначено для использования онлайн из веб-страницы. По умолчанию этот параметр имеет значение true. |
MapFileExtensions |
Необязательный параметр типа Boolean. Определяет, используется ли отображение расширения имени файла .deploy. Если значение этого параметра равно true, то каждый программный файл публикуется с расширением имени .deploy. Эта опция полезна для защиты веб-сервера, чтобы ограничить число расширений имени файла, которые должны быть разблокированы, чтобы разрешить развертывание приложения ClickOnce. По умолчанию этот параметр имеет значение false. |
MaxTargetPath |
Необязательный параметр типа String. Указывает максимально допустимую длину пути к файлу при развертывании приложений ClickOnce. Если этот параметр задан, то длина каждого пути к файлу в приложении проверяется по этому пределу. Любые элементы, которые превышают предел, вызовут предупреждение проверки построения. Если этот ввод не определен или равен нулю, то проверка не выполняется. |
MinimumRequiredVersion |
Необязательный параметр типа String. Указывает, может ли пользователь пропустить обновление. Если пользователь имеет версию, которая меньше, чем минимально необходимая, то у него не будет возможности пропуска обновления. Этот ввод применяется, только когда значение параметра Install равно true. |
OutputManifest |
Необязательный параметр типа ITaskItem. Указывает имя созданного файла результатов манифеста. Если этот параметр не задан, то имя выходного файла выводится из удостоверения созданного манифеста. |
Platform |
Необязательный параметр типа String. Определяет имя целевой платформы приложения. Этот параметр может принимать следующие значения:
Значение по умолчанию — AnyCPU. |
Product |
Необязательный параметр типа String. Указывает имя приложения. Если этот параметр не задан, то имя файла результата выводится из удостоверения созданного манифеста. Это имя используется для имени ярлыка в меню Пуск и является частью имени, которое появляется в диалоговом окне Установка или удаление программ. |
Publisher |
Необязательный параметр типа String. Указывает имя издателя приложения. Если этот параметр не задан, то имя выводится из имени зарегистрированного пользователя или из удостоверения созданного манифеста. Это имя используется для имени папки в меню Пуск и является частью имени, которое появляется в диалоговом окне Установка или удаление программ. |
SuiteNamel |
Необязательный параметр типа String. задает имя папки в меню Пуск, в которой располагается приложение после развертывания ClickOnce. |
SupportUrl |
Необязательный параметр типа String. Указывает ссылку, которая появляется в диалоговом окне Установка и удаление программ для приложения. Указанное значение должно представлять собой полный URL-адрес или UNC-путь. |
TargetCulture |
Необязательный параметр типа String. Идентифицирует язык и региональные параметры приложения и указывает поле Language удостоверения сборки для созданного манифеста. Если этот параметр не задан, то предполагается, что приложение инвариантно к языку и региональным параметрам. |
TrustUrlParameters |
Необязательный параметр типа Boolean. Указывает, должны ли параметры строки URL-запроса быть сделаны доступными приложению. Значение этого параметра по умолчанию false, которое указывает, что параметры не будут доступны приложению. |
UpdateEnabled |
Необязательный параметр типа Boolean. Указывает, разрешено ли обновление приложения. По умолчанию этот параметр имеет значение false. Этот параметр применяется, только когда значение параметра Install равно true. |
UpdateInterval |
Необязательный параметр типа Int32. Указывает интервал обновления приложения. Значение по умолчанию для этого параметра нулевое. Этот параметр применяется, только когда значения параметров Install и UpdateEnabled оба равны true. |
UpdateMode |
Необязательный параметр типа String. Указывает, должны ли обновления проверяться с высоким приоритетом до запуска приложения или в фоновом режиме, когда приложение выполняется. Этот параметр может принимать следующие значения:
По умолчанию этот параметр имеет значение Background. Этот параметр применяется, только когда значения параметров Install и UpdateEnabled оба равны true. |
UpdateUnit |
Необязательный параметр типа String. Задает единицы измерения для параметра UpdateInterval. Этот параметр может принимать следующие значения:
Этот параметр применяется, только когда значения параметров Install и UpdateEnabled оба равны true. |
Заметки
Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса GenerateManifestBase, который наследует от класса Task. Список параметров класса Task см. в описании класса Базовый класс Task.
См. также
Ссылки
Задача GenerateApplicationManifest