Засіб створення і редагування маніфесту (Mage.exe) - це засіб командного рядка, що підтримує створення і редагування маніфестів додатків і розгортання. Як засіб командного рядка програма Mage.exe може бути виконуватися як в пакетних сценаріях, так і в інших Windows-додатках, включаючи додатки ASP.NET.
Замість Mage.exe також можна використовувати MageUI.exe, графічне додаток. Додаткові відомості див. У розділі Засіб створення і редагування маніфестів, графічний клієнт (MageUI.exe).
Засоби Mage.exe і MageUI.exe доступні в різних містах, включаючи наступні:
У цій табличці вказано команди, підтримувані Mage.exe. Додаткові відомості про параметри, які підтримуються цими командами, см. В розділах Параметри команд New і Update і Параметри команди Sign.
Очищає кеш завантажених додатків для всіх додатків, що працюють інтерактивно по мережі.
-n, -New тіп_файла [новие_параметри]
Створює новий файл заданого типу. Допустимими є наступні типи:
Deployment. Створює новий маніфест розгортання.
Application. Створює новий маніфест додатка.
Якщо з цією командою не задано жодних додаткових параметрів, вона створить файл відповідного типу, з відповідними тегами за умовчанням і значеннями атрибутів.
Щоб задати ім'я файлу і шлях для нового файлу, використовується параметр -ToFile (див. У таблиці).
Щоб створити маніфест додатка з усіма збірками додатки, що були додані в розділ
-u, -Update [путь_файла] [параметри_обновленія]
Вносить один або кілька змін в файл маніфесту. Задавати тип файлу, що редагує не потрібно. Програма Mage.exe перевірить файл, використовуючи набір евристик, і визначить, чи є він маніфестом розгортання або маніфестом додатки.
Якщо розробник вже підписав файл, використовуючи сертифікат, параметр -Update видалить блок підпису ключа. Це обумовлено тим, що підпис ключа містить хеш-файлу і зміна файлу робить хеш недійсним.
Щоб задати ім'я і шлях нового файлу замість перезапису існуючого файлу, використовується параметр -ToFile (див. У таблиці).
Це новий параметр в .NET Framework 3.5.
Цей прапор використовується, тільки якщо додаток є додатком Windows Presentation Foundation (WPF), розміщених всередині оглядача Internet Explorer, а не автономним виконуваним файлом. Допустимими є значення "true" або "t" і "false" або "f".
Для маніфестів додатків вставляє атрибут hostInBrowser під елементом entryPoint маніфесту програми.
Для маніфестів розгортання встановлює значення атрибуту install для елемента deployment рівним false і зберігає маніфест розгортання, використовуючи розширення XBAP. Завдання цього аргументу разом з аргументом -Install призводить до помилки, так як додаток, що поміщається в оглядач, не може бути встановлюються, автономним додатком.
Параметри команди Sign
Наступна таблиця містить параметри, підтримувані командою -Sign. застосовуваної до всіх типів файлів.
Задає місцезнаходження цифрового сертифікату для підписання маніфесту. Цей параметр може використовуватися разом з параметром -Password.
-ch, -CertHash hashSignature
Хеш-значення цифрового сертифікату, що зберігається в сховищі персональних сертифікатів клієнтського комп'ютера. Воно відповідає властивості Thumbprint цифрового сертифікату, відображуваного в консолі сертифікатів Windows.
Параметр hashSignature може бути заданий або в верхньому, або в нижньому регістрі, і може надаватися або як цілий рядок, або у вигляді всіх октетів властивості Thumbprint, розділених пробілами, і всього властивості Thumbprint, укладеного в лапки.
Пароль, який використовується для підписання маніфесту за допомогою цифрового сертифікату. Повинен використовуватися разом з параметром -CertFile.
Підписання - це останнє завдання, яке повинен виконати розробник, так як підписаний документ використовує хеш-значення файлу, щоб перевірити правильність підпису документа. При внесенні в файл будь-яких змін розробник повинен підписати цей файл знову. Якщо підписується документ, який вже був підписаний, програма Mage.exe замінює стару підпис нової.
При використанні параметра -AppManifest для заповнення маніфесту розгортання програма Mage.exe передбачає, що маніфест додатка буде знаходитися в тому ж каталозі, що і маніфест розгортання, в підкаталозі, назва якого відповідає поточній версії розгортання, і відповідним чином налаштовує маніфест розгортання. Якщо маніфест додатка буде перебувати в іншому місці, для установки альтернативного місцезнаходження можна використовувати параметр -AppCodeBase.
Перед розгортанням додатка маніфест розгортання і маніфест додатка повинні бути підписані. Керівництво по підписанню документів див. Розділ Загальні відомості про розгортання довірених додатків.
У наступному прикладі відкривається призначений для користувача інтерфейс для Mage (MageUI.Exe).
У наступних прикладах створюються маніфест розгортання за замовчуванням і маніфест додатка. Ці файли створюються в поточному робочому каталозі і називаються deploy.application і application.exe.manifest, відповідно.