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.

См. также