MageUI.exe (generování manifestu a nástroj pro úpravy, grafický klient)
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. |
