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. Если параметр задачи EntryPoint не указан, тег <customHostSpecified> вставляется в качестве дочернего элемента тега <entryPoint>, например:<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2"><co.v1:customHostSpecified /></entryPoint>В манифест приложения можно добавить зависимости DLL следующим образом: 1. Разрешите ссылки на сборки с помощью вызова ResolveAssemblyReference. 2. Передайте выходные данные предыдущей задачи и самой сборки в ResolveManifestFiles. 3. Передайте зависимости с помощью параметра Dependencies в GenerateApplicationManifest. |
ErrorReportUrl |
Необязательный параметр System.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- x86- x64- ItaniumЗначение по умолчанию — 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.Указывает, должны ли обновления проверяться на переднем плане перед запуском приложения или в фоновом режиме во время выполнения приложения. Этот параметр может иметь следующие значения: - Foreground- BackgroundЗначение параметра по умолчанию — Background. Этот параметр применяется, только когда оба параметра Install и UpdateEnabled имеют значение true. |
UpdateUnit |
Необязательный параметр String.Указывает единицы измерения для параметра UpdateInterval. Этот параметр может иметь следующие значения:- Hours- Days- WeeksЭтот параметр применяется, только когда оба параметра Install и UpdateEnabled имеют значение true. |
Замечания
Помимо перечисленных выше параметров, эта задача наследует параметры от класса GenerateManifestBase, который, в свою очередь, наследует от класса Task. Список параметров класса Task см. в статье Базовый класс Task.