MageUI.exe (средство создания манифеста и редактирования, графический клиент)

MageUI.exe поддерживает те же функции, что и средство командной строки Mage.exe, но с пользовательским интерфейсом на основе Windows. С помощью этого средства можно создавать, редактировать и подписывать манифесты развертывания и приложения. Новые манифесты, созданные с помощью MageUI.exe целевого профиля клиента .NET Framework 4. Предыдущие версии MageUI.exe должны использоваться для назначения предыдущих версий .NET Framework. При добавлении или удалении сборок из манифеста или повторной подписи существующих манифестов MageUI.exe не обновляет манифест для целевого профиля клиента .NET Framework 4. Дополнительные сведения см. в разделеMage.exe (средство создания манифеста и редактирования).

Эта программа автоматически устанавливается вместе с Visual Studio. Чтобы запустить средство, используйте командную строку разработчика Visual Studio или Visual Studio Developer PowerShell.

Две версии Mage.exe и MageUI.exe включены в состав Visual Studio. Чтобы просмотреть сведения о версии, выполните MageUI.exe, выберите "Справка" и выберите "О". В этой документации описывается версия 4.0.x.x Mage.exe и MageUI.exe.

Замечание

MageUI.exe не поддерживает совместимый элементFrameworks при сохранении манифеста приложения, который уже подписан сертификатом с помощью MageUI.exe. Вместо этого необходимо использовать Mage.exe.

Список элементов пользовательского интерфейса

В следующей таблице перечислены доступные элементы меню и панели инструментов.

Command Меню Shortcut Description
Манифест приложения Файл, создать Создает новый манифест приложения.
Манифест развертывания Файл, создать Создает новый манифест развертывания.
Открыть Файл CTRL+O Открывает существующий манифест развертывания, манифест приложения или лицензию доверия для редактирования.
Закрыть Файл CTRL+F4 Закрывает открытый файл.

Если перед закрытием файла изменить файл, MageUI.exe предложит повторно подписать файл с помощью открытого ключа, пары ключей или хранимого сертификата.
Сохранить Файл CTRL+S Сохраняет на диске документ, который в настоящее время имеет фокус ввода пользователей.
сохранить как Файл Сохраняет файл на диск, позволяя указать новое имя файла и (или) расположение.
Сохранить все Файл Сохраняет изменения, внесенные во все файлы, открытые в MageUI.exe.
Preferences Файл Открывает диалоговое окно "Параметры ". Дополнительные сведения см. в следующем разделе.
Exit Файл ALT+F4 Завершает работу MageUI.exe.
Вырезать Изменить CTRL+X Удаляет выделенный текст из приложения и перемещает его в системный буфер обмена.
Copy Изменить CTRL+C Копирует выделенный в данный момент текст в системный буфер обмена.
Вставить Изменить CTRL+V Вставляет текст из системного буфера обмена в текущий активный текстовый элемент.
Удалить Изменить Удаляет элемент, выбранный в списке, например лицензию доверия на вкладке манифеста развертывания .
Закрыть всё Окно Закрывает все файлы, открытые в MageUI.exe. Если нужно сохранить один или несколько файлов, MageUI.exe предложит сохранить их. MageUI.exe также предлагает выбрать ключ подписи для каждого файла без знака или измененного файла.
About Помощь Отображает сведения о версии и авторских правах о MageUI.exe.

Диалоговое окно "Параметры"

Диалоговое окно "Параметры" содержит следующие элементы.

Элемент пользовательского интерфейса Description
Вход в систему для сохранения Запрашивает подписывать файл при сохранении изменений.
Использование сертификата подписи по умолчанию Использует ключ, введенный в текстовом поле файла сертификата , для подписывания всех файлов. Это устраняет запрос подписывания, который обычно отображается при сохранении файла и выбран параметр "Сохранить". Нажмите кнопку с многоточием (...) рядом с текстовым полем файла сертификата , чтобы выбрать файл ключа.
Алгоритм дайджеста Определяет алгоритм создания дайджестов зависимостей. Значение должно быть sha256RSA или sha1RSA. Использует SHA1 в качестве значения по умолчанию. Используется как в манифестах приложения, так и в развертывании. Если пользователь предоставляет сертификат при сохранении манифеста, использует алгоритмы в сертификате для создания дайджестов зависимостей.

Диалоговое окно "Параметры подписывания"

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

Это диалоговое окно содержит следующие элементы.

Элемент пользовательского интерфейса Description
Вход с помощью файла сертификата Подписывает манифест цифровым сертификатом, хранящимся в файловой системе.
Файл Предоставляет область для ввода пути к PFX-файлу, представляющего сертификат.
... Открывает диалоговое окно "Выбор файла" для выбора существующего PFX-файла.
Новый Создает новый PFX-файл, который не проверяется через центр сертификации (ЦС). Дополнительные сведения о типах сертификатов, используемых для подписывания развертываний ClickOnce, см. в обзоре развертывания доверенных приложений.
Пароль Предоставляет область для ввода пароля, используемого для подписывания с помощью этого сертификата. Если применимо, можно оставить пустым.
Вход с помощью хранимого сертификата Отображает список цифровых сертификатов, хранящихся в хранилище сертификатов компьютера.
Универсальный код ресурса (URI) метки времени Отображает универсальный указатель ресурсов (URI) службы цифровой метки времени. Метка времени манифестов запрещает повторно подписывать манифесты, если срок действия цифрового сертификата истекает до развертывания следующей версии приложения. Дополнительные сведения см. в разделе "Члены программы корневого сертификата Windows " и ClickOnce и Authenticode.
Не подписывайте Позволяет сохранить манифест без добавления подписи из цифрового сертификата.

Описания вкладок и панелей

При открытии документа с MageUI.exeона отображается на собственной странице вкладок. Каждая вкладка содержит набор панелей свойств. Панели содержат сгруппированные подмножества данных документа.

Вкладка манифеста приложения

На вкладке "Манифест приложения" отображается содержимое манифеста приложения. Манифест приложения описывает все файлы, включенные в развертывание, и разрешения, необходимые для запуска приложения на клиенте.

Вкладка манифеста приложения содержит следующие вкладки.

Элемент пользовательского интерфейса Description
Имя Указывает идентификацию сведений об этом развертывании.
Описание Указывает сведения о издателе, продукте и поддержке.
Параметры приложения Указывает, является ли это браузерным приложением и является ли этот манифест источником сведений о доверии.
Files Указывает все файлы, составляющие это развертывание.
Требуемые разрешения Указывает минимальный набор разрешений, необходимый приложению для запуска на клиенте.

Вкладка "Имя"

Вкладка "Имя" отображается при первом создании или открытии манифеста приложения. Он однозначно идентифицирует развертывание и при необходимости задает допустимую целевую платформу.

Элемент пользовательского интерфейса Description
Имя Обязательное. Имя манифеста приложения. Обычно совпадает с именем файла.
Версия Обязательное. Номер версии развертывания в форме N.N.N.N. Требуется только первый основной номер сборки. Например, для версии 1.0 приложения допустимые значения включают 1, 1.0и 1.0.01.0.0.0.
Процессор Необязательно. Архитектура компьютера, на которой может выполняться это развертывание. По умолчанию используется msilязык microsoft intermediate, который является форматом по умолчанию для всех управляемых сборок. Измените это поле, если вы предварительно скомпилировали сборки в приложении для определенной архитектуры. Дополнительные сведения о предварительной компиляции см. в разделе Ngen.exe (генератор образов машинного кода).
Culture Необязательно. Двухуровневый код страны и региона ISO, в котором выполняется это приложение. Значение по умолчанию — neutral.
Маркер открытого ключа Необязательно. Открытый ключ, с помощью которого подписан этот манифест приложения. Если это новый или неподписанный манифест, это поле будет отображаться как Unsigned.

Вкладка "Описание"

Обычно эти сведения предоставляются в манифесте развертывания. Эти поля можно изменить только в том случае, если установлен флажок "Использовать сведения о доверии манифеста приложения " на вкладке "Параметры приложения ".

Элемент пользовательского интерфейса Description
Publisher Имя человека или организации, ответственного за приложение. Это значение используется в качестве имени папки меню "Пуск".
Продукт Полное имя продукта. Если вы выбрали "Установить локально " для элемента "Тип приложения " на вкладке "Параметры развертывания" манифеста развертывания, это имя будет отображаться в ссылке меню "Пуск " и в разделе "Добавление или удаление программ " для этого приложения.
Расположение поддержки URL-адрес, из которого клиенты могут получить справку и поддержку приложения.

Вкладка "Параметры приложения"

Элемент пользовательского интерфейса Description
Приложение браузера Windows Presentation Foundation Указывает, является ли это приложение WPF, которое выполняется в браузере в качестве приложения браузера XAML (XBAP).
Использование сведений о доверии манифеста приложения Указывает, содержит ли этот манифест сведения о доверии.

Вкладка "Файлы"

Элемент пользовательского интерфейса Description
Каталог приложений Каталог, в котором находятся файлы приложения. Нажмите кнопку с многоточием (...), чтобы выбрать каталог.
Населять Добавляет все файлы в каталог приложения и вложенные каталоги в манифест приложения. Если MageUI.exe найти один исполняемый файл в каталоге, он автоматически помечает его как точку входа, которая впервые выполняется при запуске приложения ClickOnce на клиенте.
Файлы приложений Выводит список всех файлов в приложении. Каждый файл имеет три редактируемых атрибута, рассмотренные ниже.
Тип файла Тип файла может быть одним из четырех значений:

- Нет.
-Точка входа. Основной исполняемый файл приложения. Только один исполняемый файл можно пометить как точку входа.
-Файл данных. Файл, например XML-файл, предоставляющий данные приложению.
— Файл значка. Значок приложения, например на рабочем столе или в углу окна приложения.
Необязательно Файлы, помеченные как необязательные, не скачиваются при первоначальной установке или обновлении, но могут быть скачаны во время выполнения с помощью API System.Deployment on-Demand. Дополнительные сведения см. в пошаговом руководстве. Скачивание сборок по запросу с помощью API развертывания ClickOnce с помощью конструктора.
Группа Метка набора необязательных файлов. Вы можете применить метку группы к набору файлов и использовать API по запросу для скачивания пакета файлов с одним вызовом API.

Вкладка "Необходимые разрешения"

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

Элемент пользовательского интерфейса Description
Тип набора разрешений Минимальный набор разрешений, необходимый этому приложению для запуска на клиенте. Описание этих наборов разрешений и разрешения, которые они выполняют или не требуют, см. в разделе Именованные наборы разрешений.
Сведения XML-код, созданный для манифеста приложения для представления набора разрешений. Если у вас нет хорошего понимания XML-формата манифеста приложения, этот XML-файл не следует редактировать вручную. Дополнительные сведения см. в разделе "Манифест приложения ClickOnce".

Вкладка манифеста развертывания

Вкладка манифеста развертывания содержит следующие вкладки.

Элемент пользовательского интерфейса Description
Имя Указывает идентификацию сведений об этом развертывании.
Описание Указывает сведения о издателе, продукте и поддержке.
Параметры развертывания Указывает дополнительные сведения о развертывании, например тип приложения и расположение начала.
Параметры обновления Указывает, как часто ClickOnce должен проверять наличие обновлений приложений.
Справочник по приложениям Указывает манифест приложения для этого развертывания.

Вкладка "Имя"

Вкладка "Имя" отображается при первом создании или открытии манифеста развертывания. Он однозначно идентифицирует развертывание и при необходимости задает допустимую целевую платформу.

Элемент пользовательского интерфейса Description
Имя Обязательное. Имя манифеста развертывания. Обычно совпадает с именем файла.
Версия Обязательное. Номер версии развертывания в форме N.N.N.N. Требуется только первый основной номер сборки. Например, для версии 1.0 приложения допустимые значения включают 1, 1.0и 1.0.01.0.0.0.
Процессор Необязательно. Архитектура компьютера, на которой может выполняться это развертывание. Значение по умолчанию — msil(или Microsoft Intermediate Language) — формат по умолчанию для всех управляемых сборок. Измените это поле, если вы скомпилировали сборки в приложении для определенной архитектуры.
Culture Необязательно. Код страны или региона ISO, в котором выполняется это приложение. Значение по умолчанию — neutral.
Маркер открытого ключа Необязательно. Открытый ключ, с которым подписан этот манифест развертывания. Если это новый или неподписанный манифест, это поле будет отображаться как Unsigned.

Вкладка "Описание"

Элемент пользовательского интерфейса Description
Publisher Обязательное. Имя человека или организации, ответственного за приложение. Это значение используется в качестве имени папки меню "Пуск".
Продукт Обязательное. Полное имя продукта. Если вы выбрали "Установить локально " для элемента "Тип приложения " на вкладке "Параметры развертывания ", это имя будет отображаться в ссылке меню "Пуск " и в разделе "Добавление или удаление программ " для этого приложения.
Расположение поддержки Необязательно. URL-адрес, из которого клиенты могут получить справку и поддержку приложения.

Вкладка "Параметры развертывания"

Элемент пользовательского интерфейса Description
Тип приложения Необязательно. Указывает, устанавливается ли это приложение на клиентский компьютер (установка локально), выполняется в сети (только в Сети) или является приложением WPF, которое выполняется в браузере (приложение браузера WPF). По умолчанию используется локальная установка.
Начальная локация Необязательно. URL-адрес, с которого должно быть запущено приложение. Полезно при развертывании приложения из компакт-диска, который должен обновляться из Интернета.
Включение расположения запуска (ProviderURL) в манифест Необязательно. Задает URL-адрес, который приложение ClickOnce будет использовать для обновлений приложения.
Автоматическое запуск приложения после установки Обязательное. Указывает, что приложение ClickOnce должно выполняться сразу после начальной установки из URL-адреса. По умолчанию установлен флажок.
Разрешить передаче параметров URL-адреса приложению Обязательное. Разрешает передачу данных параметров в приложение ClickOnce через строку запроса, добавленную к URL-адресу манифеста развертывания. По умолчанию флажок снят.
Использование расширения .deploy file Обязательное. При выборе все файлы в манифесте приложения должны иметь расширение .deploy. По умолчанию флажок снят.

Вкладка "Параметры обновления"

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

Элемент пользовательского интерфейса Description
Это приложение должно проверить наличие обновлений Указывает, должен ли ClickOnce проверять наличие обновлений приложений. Если этот флажок не установлен, приложение не будет проверять наличие обновлений, если только вы не обновляете его программным способом с помощью API в System.Deployment.Application пространстве имен.
Выберите, когда приложение должно проверить наличие обновлений Предоставляет два варианта проверки обновлений:

- Перед началом работы приложения. Проверка обновления выполняется до выполнения приложения.
- После запуска приложения. Проверка обновления начинается после инициализации основной формы приложения и запустится при следующем запуске приложения.
Частота проверки обновления Определяет частоту проверки наличия обновлений ClickOnce:

- Проверяйте каждый раз при запуске приложения. ClickOnce будет выполнять проверку обновления каждый раз, когда пользователь открывает приложение.
- Проверьте каждый: выберите интервал времени и единицу (часы, дни или недели), которые должны пройти перед проверкой обновлений.
Укажите минимальную требуемую версию для этого приложения Необязательно. Указывает, что определенная версия приложения является обязательной установкой, предотвращая работу пользователей с более ранней версией.
Версия Требуется, если выбрана минимальная требуемая версия для этого приложения . Номер версии должен иметь форму N.N.N.N.N. Требуется только первый основной номер сборки. Например, для версии 1.0 приложения допустимые значения включают 1, 1.0и 1.0.01.0.0.0.

Вкладка "Справочник по приложениям"

Вкладка "Справочник по приложениям" содержит те же поля, что и вкладка "Имя ", описанная ранее в этом разделе. Одно из исключений — это следующее поле.

Элемент пользовательского интерфейса Description
Выбор манифеста Позволяет выбрать манифест приложения. Все остальные поля на этой странице заполнятся при выборе манифеста приложения.

См. также

  • Last updated on