MageUI.exe (generování manifestu a nástroj pro úpravy, grafický klient)

  • Článek

Nástroj MageUI.exe podporuje stejné funkce jako nástroj příkazového řádku Mage.exe, ale používá uživatelské rozhraní (UI) založené na systému Windows. Pomocí tohoto nástroje je možné vytvářet, upravovat a podepisovat manifesty nasazení a aplikací. Nové manifesty vytvořené pomocí MageUI.exe cílí na profil klienta rozhraní .NET Framework 4. Pro straší verze rozhraní .NET Framework byste měli použít starší verze nástroje MageUI.exe. Při přidávání nebo odebírání sestavení z manifestu nebo při opětovném podepisování existujících manifestů nástroj MageUI.exe neaktualizuje manifest na cílový profil klienta rozhraní .NET Framework 4. Další informace najdete v tématu Mage.exe (Manifest Generation and Editing Tool).

Tento nástroj je automaticky nainstalován se sadou Visual Studio. Ke spuštění nástroje použijte Visual Studio Developer Command Prompt nebo Visual Studio Developer PowerShell.

Jako součást sady Visual Studio jsou zahrnuty dvě verze Mage.exe a MageUI.exe. Pokud chcete zobrazit informace o verzi, spusťte MageUI.exe, vyberte Nápověda a vyberte O produktu. Tato dokumentace popisuje verzi 4.0.x.x nástrojů Mage.exe a MageUI.exe.

Poznámka

MageUI.exe nepodporuje element compatibleFrameworks při ukládání manifestu aplikace, který již byl podepsán certifikátem pomocí MageUI.exe. Místo toho musíte použít Mage.exe.

Seznam prvků uživatelského rozhraní

Následující tabulka obsahuje dostupné položky nabídek a panelu nástrojů.

Příkaz Nabídka Zástupce Description
Manifest aplikace Soubor, nový Vytvoří nový manifest aplikace.
Manifest nasazení Soubor, nový Vytvoří nový manifest nasazení.
Otevřít Soubor CTRL+O Otevře existující manifest nasazení, manifest aplikace nebo důvěryhodnou licenci v režimu úprav.
Zavřít Soubor CTRL+F4 Zavře otevřený soubor.

Upravíte-li soubor před jeho uzavřením, požádá nástroj MageUI.exe o opětovné podepsání souboru veřejným klíčem, párem klíčů nebo uloženým certifikátem.
Uložit Soubor CTRL+S Uloží soubor, na který je aktuálně zaměřen uživatelský vstup, na disk.
Uložit jako Soubor Uloží soubor na disk a umožní zadat název souboru nebo jeho umístění.
Uložit vše Soubor Uloží změny pro všechny soubory otevřené v rámci nástroje MageUI.exe.
Předvolby Soubor Otevře dialogové okno Předvolby . Další informace naleznete v následující části.
Ukončit Soubor ALT+F4 Ukončí nástroj MageUI.exe.
Vyjmout Upravit CTRL+X Odstraní aktuálně vybraný text z aplikace a uloží jej do schránky.
Kopírovat Upravit CTRL+C Zkopíruje aktuálně vybraný text do schránky.
Vložit Upravit CTRL+V Vloží text ze schránky do aktuálního textového prvku.
Odstranit Upravit Odstraní prvek aktuálně vybraný v seznamu, například důvěryhodnou licenci na kartě Manifest nasazení .
Zavřít vše Okno Zavře všechny soubory otevřené v nástroji MageUI.exe. Pokud je zapotřebí některé ze souborů uložit, vyzve nástroj MageUI.exe k jejich uložení. Nástroj MageUI.exe také vyžaduje výběr podepsaného klíče pro každý nepodepsaný nebo změněný soubor.
O aplikaci Nápověda Zobrazuje verzi a informace o autorských právech nástroje MageUI.exe.

Dialogové okno Předvolby

Dialogové okno Předvolby obsahuje následující prvky.

Prvek uživatelského rozhraní (UI) Description
Uložit přihlášení Při uložení změn vyžaduje podepsání souboru.
Použít výchozí podpisový certifikát Pomocí klíče zadaného v textovém poli Soubor certifikátu podepíše všechny soubory. Tím se eliminuje výzva k podepsání, která se obvykle zobrazí, když uložíte soubor a vyberete Možnost Uložit přihlásit se . Pomocí tlačítka se třemi tečky (...) vedle textového pole Soubor certifikátu vyberte soubor klíče.
Algoritmus Digest Určí algoritmus, jímž budou generovány přehledy závislostí. Hodnotou musí být „sha256RSA“ nebo „sha1RSA“. Použije SHA1 jako výchozí. Tato hodnota je použita v aplikaci i v manifestech nasazení. Pokud uživatel při ukládání manifestu zadá certifikát, použije se algoritmus v tomto certifikátu k vygenerování přehledu závislostí.

Dialogové okno Možnosti podpisu

Dialogové okno Možnosti podepsání se zobrazí při prvním uložení manifestu nebo důvěryhodné licence nebo při změně manifestu nebo důvěryhodné licence. Zobrazí se pouze v případě, že je v dialogovém okně Předvolby vybraná možnost Přihlásit se k uložení. Při podepisování manifestu, který určuje hodnotu v textovém poli Identifikátor URI časového razítka , musíte být připojení k internetu.

Toto dialogové okno obsahuje následující prvky.

Prvek uživatelského rozhraní (UI) Description
Podepsat se souborem certifikátu Podepíše manifest digitálním certifikátem uloženým v systému souborů.
Soubor Poskytuje prostor pro zadání cesty k souboru .pfx představujícímu certifikát.
... Otevře dialogové okno Zvolit soubor pro výběr existujícího souboru .pfx.
Nový Vytvoří nový soubor .pfx, který nelze ověřit skrze certifikační autoritu (CA). Další informace o typech certifikátů používaných k podepisování nasazení ClickOnce najdete v tématu Přehled nasazení důvěryhodných aplikací.
Heslo Poskytuje prostor pro zadání hesla použitého k podepisování certifikátů. Pokud není použito, může být ponecháno prázdné.
Podepsání pomocí uloženého certifikátu Zobrazí seznam s vlastním výběrem digitálních certifikátů uložených v úložišti certifikátů počítače.
Identifikátor URI časového razítka Zobrazí adresu Uniform Resource Locator (URI) služby digitálního časového razítka. Vytvoření časového razítka v manifestu umožňuje vyhnout se nutnosti znovu manifesty podepisovat v případě, že digitální certifikát vyprší ještě před nasazením další verze aplikace. Další informace najdete v tématech Členové programu kořenových certifikátů systému Windows a ClickOnce a Authenticode.
Nepodepisovat Umožňuje uložit manifest bez přidání podpisu z digitálního certifikátu.

Popisy karet a panelů

Dokument se při otevření pomocí nástroje MageUI.exe zobrazí na vlastní kartě. Každá karta obsahuje sadu panelů vlastností. Panely obsahují seskupenou podmnožinu dat dokumentu.

Karta Manifest aplikace

Na kartě Manifest aplikace se zobrazí obsah manifestu aplikace. Manifest aplikace popisuje všechny soubory zahrnuté v nasazení a oprávnění potřebná ke spuštění aplikace na klientovi.

Karta Manifest aplikace obsahuje následující karty.

Prvek uživatelského rozhraní (UI) Popis
Název Určuje identifikační informace o tomto nasazení.
Popis Určuje informace o vydavateli, produktu a podpoře.
Možnosti aplikace Určuje, zda se jedná o aplikaci prohlížeče a zda je tento manifest zdrojem informací o důvěryhodnosti.
Soubory Určuje všechny soubory, které tvoří toto nasazení.
Požadovaná oprávnění Určuje minimální sadu oprávnění vyžadovanou aplikací ke spuštění na klientovi.

Karta Název

Karta Název se zobrazí při prvním vytvoření nebo otevření manifestu aplikace. Jednoznačně identifikuje nasazení a volitelně určuje platnou cílovou platformu.

Prvek uživatelského rozhraní (UI) Popis
Název Povinná hodnota. Název manifestu aplikace. Obvykle stejný jako název souboru.
Verze Povinná hodnota. Číslo verze nasazení ve tvaru N.N.N.N. Vyžaduje se pouze první číslo hlavního sestavení. Například pro verzi 1.0 aplikace by platné hodnoty zahrnovaly 1, 1.0, 1.0.0a 1.0.0.0.
Procesor Nepovinný parametr. Architektura počítače, na které může toto nasazení běžet. Výchozí je msil, nebo Microsoft Intermediate Language, což je výchozí formát všech spravovaných sestavení. Toto pole změňte, pokud jste předem zkompilovali sestavení v aplikaci pro konkrétní architekturu. Další informace o předběžné kompilaci najdete v tématu Ngen.exe (Native Image Generator).
Kultura Nepovinný parametr. Dvoudílný kód iso země a oblasti, ve kterém se tato aplikace spouští. Výchozí formát je neutral.
Token veřejného klíče Nepovinný parametr. Veřejný klíč, kterým byl tento manifest aplikace podepsán. Pokud se jedná o nový nebo nepodepsaný manifest, zobrazí se toto pole jako Unsigned.

Karta Popis

Tyto informace se obvykle poskytují v manifestu nasazení. Tato pole lze upravit pouze v případě, že je na kartě Možnosti aplikace zaškrtnuté políčko Použít informace o důvěryhodnosti manifestu aplikace.

Prvek uživatelského rozhraní (UI) Description
Publisher Jméno osoby nebo organizace zodpovědné za aplikaci. Tato hodnota se používá jako název složky nabídky Start.
Product (Produkt) Úplný název produktu. Pokud jste u elementu Typ aplikace na kartě Možnosti nasazení v manifestu nasazení vybrali možnost Instalovat místně, zobrazí se tento název v odkazu nabídky Start a v části Přidat nebo odebrat programy pro tuto aplikaci.
Umístění podpory Adresa URL, ze které můžou zákazníci získat nápovědu a podporu pro aplikaci.

Karta Možnosti aplikace

Prvek uživatelského rozhraní (UI) Description
aplikace Windows Presentation Foundation Browser Určuje, jestli se jedná o aplikaci WPF, která běží v prohlížeči jako aplikace prohlížeče XAML (XBAP).
Použití informací o důvěryhodnosti manifestu aplikace Určuje, zda tento manifest obsahuje informace o důvěryhodnosti.

Karta Soubory

Prvek uživatelského rozhraní (UI) Description
Adresář aplikace Adresář, ve kterém se nacházejí soubory aplikace. Pomocí tlačítka se třemi tečkami (...) vyberte adresář.
Naplnění Přidá všechny soubory v adresáři aplikace a podadresáře do manifestu aplikace. Pokud MageUI.exe najde v adresáři jeden spustitelný soubor, automaticky ho označí jako vstupní bod, což je soubor, který se poprvé spustí při spuštění aplikace ClickOnce v klientovi.
Soubory aplikace Zobrazí seznam všech souborů v aplikaci. Každý soubor má tři upravitelné atributy, které jsou popsány níže.
Typ souboru Typ souboru může být jedna ze čtyř hodnot:

-Žádný.
- Vstupní bod. Primární spustitelný soubor aplikace. Jako vstupní bod lze označit pouze jeden spustitelný soubor.
– Datový soubor. Soubor, například soubor XML, který do aplikace dodává data.
- Soubor ikony. Ikona aplikace, například zobrazená na ploše nebo v rohu okna aplikace.
Volitelné Soubory označené jako volitelné se při počáteční instalaci nebo aktualizaci nestáhnou, ale mohou být staženy za běhu pomocí rozhraní API System.Deployment On-Demand. Další informace najdete v tématu Návod: Stažení sestavení na vyžádání pomocí rozhraní API pro nasazení ClickOnce pomocí Návrháře.
Skupina Popisek pro sadu volitelných souborů. U sady souborů můžete použít popisek skupiny a pomocí rozhraní API na vyžádání stáhnout dávku souborů s jedním voláním rozhraní API.

Karta Požadovaná oprávnění

Kartu Požadovaná oprávnění použijte, pokud potřebujete aplikaci udělit více přístupu k místnímu počítači, než je uděleno ve výchozím nastavení. Další informace najdete v tématu Zabezpečení aplikací ClickOnce.

Prvek uživatelského rozhraní (UI) Description
Typ sady oprávnění Minimální sada oprávnění vyžadovaná touto aplikací ke spuštění na klientovi. Popis těchto sad oprávnění a oprávnění, která vyžadují, najdete v tématu Pojmenované sady oprávnění.
Podrobnosti Soubor XML vytvořený pro manifest aplikace, který představuje sadu oprávnění. Pokud nemáte dobrou znalost formátu XML manifestu aplikace, neměli byste tento XML upravovat ručně. Další informace najdete v tématu Manifest aplikace ClickOnce.

Karta Manifest nasazení

Karta Manifest nasazení obsahuje následující karty.

Prvek uživatelského rozhraní (UI) Popis
Název Určuje identifikační informace o tomto nasazení.
Popis Určuje informace o vydavateli, produktu a podpoře.
Možnosti nasazení Určuje další informace o nasazení, například typ aplikace a umístění spuštění.
Možnosti aktualizace Určuje, jak často má ClickOnce kontrolovat aktualizace aplikací.
Referenční dokumentace k aplikaci Určuje manifest aplikace pro toto nasazení.

Karta Název

Karta Název se zobrazí při prvním vytvoření nebo otevření manifestu nasazení. Jednoznačně identifikuje nasazení a volitelně určuje platnou cílovou platformu.

Prvek uživatelského rozhraní (UI) Popis
Název Povinná hodnota. Název manifestu nasazení. Obvykle stejný jako název souboru.
Verze Povinná hodnota. Číslo verze nasazení ve tvaru N.N.N.N. Vyžaduje se pouze první číslo hlavního sestavení. Například pro verzi 1.0 aplikace by platné hodnoty zahrnovaly 1, 1.0, 1.0.0a 1.0.0.0.
Procesor Nepovinný parametr. Architektura počítače, na které může toto nasazení běžet. Výchozí je msil, neboli Microsoft Intermediate Language, výchozí formát všech spravovaných sestavení. Toto pole změňte, pokud jste zkompilovali sestavení v aplikaci pro konkrétní architekturu.
Kultura Nepovinný parametr. Dvoudílný kód ISO země/oblasti, ve kterém se tato aplikace spouští. Výchozí formát je neutral.
Token veřejného klíče Nepovinný parametr. Veřejný klíč, se kterým je tento manifest nasazení podepsaný. Pokud se jedná o nový nebo nepodepsaný manifest, zobrazí se toto pole jako Unsigned.

Karta Popis

Prvek uživatelského rozhraní (UI) Description
Publisher Povinná hodnota. Jméno osoby nebo organizace zodpovědné za aplikaci. Tato hodnota se používá jako název složky nabídky Start.
Product (Produkt) Povinná hodnota. Úplný název produktu. Pokud jste pro element Typ aplikace na kartě Možnosti nasazení vybrali Možnost Instalovat místně, bude se tento název zobrazovat v odkazu nabídky Start a v části Přidat nebo odebrat programy pro tuto aplikaci.
Umístění podpory Nepovinný parametr. Adresa URL, ze které můžou zákazníci získat nápovědu a podporu pro aplikaci.

Karta Možnosti nasazení

Prvek uživatelského rozhraní (UI) Description
Typ aplikace Nepovinný parametr. Určuje, jestli se tato aplikace nainstaluje do klientského počítače (nainstalovat místně), spustí se online (jenom online) nebo jestli se jedná o aplikaci WPF, která běží v prohlížeči (aplikace prohlížeče WPF). Výchozí nastavení je Nainstalovat místně.
Počáteční umístění Nepovinný parametr. Adresa URL, ze které by se měla aplikace skutečně spustit. Užitečné při nasazování aplikace z disku CD, který by se měl aktualizovat z webu.
Zahrnout počáteční umístění (ProviderURL) do manifestu Nepovinný parametr. Určuje adresu URL, na které technologie ClickOnce vyhledá aktualizace aplikace.
Automatické spuštění aplikace po instalaci Povinná hodnota. Určuje, že aplikace ClickOnce by se měla spustit ihned po počáteční instalaci z adresy URL. Ve výchozím nastavení je políčko zaškrtnuté.
Povolit předávání parametrů adresy URL do aplikace Povinná hodnota. Umožňuje přenos dat parametrů do aplikace ClickOnce prostřednictvím řetězce dotazu připojeného k adrese URL manifestu nasazení. Výchozí hodnota je, že políčko není zaškrtnuté.
Použití přípony souboru .deploy Povinná hodnota. Pokud je tato možnost vybraná, všechny soubory v manifestu aplikace musí mít příponu .deploy. Výchozí hodnota je, že políčko není zaškrtnuté.

Karta Možnosti aktualizace

Karta Možnosti aktualizace obsahuje možnosti uvedené pouze v tomto článku, pokud je pole pro výběr Typu aplikace na kartě Název nastaveno na Instalovat místně.

Prvek uživatelského rozhraní (UI) Description
Tato aplikace by měla vyhledat aktualizace. Určuje, jestli má ClickOnce vyhledat aktualizace aplikací. Pokud toto políčko není zaškrtnuté, aplikace nebude vyhledávat aktualizace, dokud ji neaktualizujete programově pomocí rozhraní API v System.Deployment.Application oboru názvů .
Zvolte, kdy má aplikace vyhledat aktualizace. Poskytuje dvě možnosti kontroly aktualizací:

- Před spuštěním aplikace. Kontrola aktualizace se provádí před spuštěním aplikace.
- Po spuštění aplikace. Kontrola aktualizace začne po inicializaci hlavního formuláře aplikace a spustí se při příštím spuštění aplikace.
Frekvence kontroly aktualizací Určuje, jak často má ClickOnce vyhledávat aktualizace:

- Zkontrolujte pokaždé, když se aplikace spustí. ClickOnce provede kontrolu aktualizace pokaždé, když uživatel aplikaci otevře.
- Kontrolovat každých: Vyberte časový interval a jednotku (hodiny, dny nebo týdny), které musí uplynou před vyhledáním aktualizací.
Zadejte minimální požadovanou verzi pro tuto aplikaci. Nepovinný parametr. Určuje, že konkrétní verze aplikace je požadovaná instalace, což uživatelům brání v práci se starší verzí.
Verze Vyžaduje se, pokud je zaškrtnuté políčko Zadat minimální požadovanou verzi pro tuto aplikaci . Zadané číslo verze musí být ve tvaru N.N.N.N. Vyžaduje se jenom číslo prvního hlavního buildu. Například pro verzi 1.0 aplikace by platné hodnoty zahrnovaly 1, 1.0, 1.0.0a 1.0.0.0.

Karta Reference aplikace

Karta Reference k aplikaci obsahuje stejná pole jako karta Název popsaná výše v tomto tématu. Jedinou výjimkou je následující pole.

Prvek uživatelského rozhraní (UI) Description
Vybrat manifest Umožňuje zvolit manifest aplikace. Všechna ostatní pole na této stránce se vyplní, když zvolíte manifest aplikace.

Viz také