Návod: Ruční nasazení aplikace ClickOnce

  • Článek

Pokud k nasazení aplikace ClickOnce nemůžete použít Sadu Visual Studio nebo potřebujete použít pokročilé funkce nasazení, jako je nasazení důvěryhodných aplikací, měli byste k vytvoření manifestů ClickOnce použít nástroj příkazového Mage.exe řádku. Tento návod popisuje, jak vytvořit nasazení ClickOnce pomocí verze příkazového řádku (Mage.exe) nebo grafické verze (MageUI.exe) nástroje pro generování a úpravy manifestu.

Poznámka:

V clickOnce pro .NET Core 3.1 a .NET 5 nebo novější použijte místo Mage.exe dotnet-mage.exe. Další informace naleznete v tématu ClickOnce pro .NET.

Požadavky

Tento názorný postup obsahuje některé požadavky a možnosti, které je potřeba zvolit před sestavením nasazení.

  • Instalace Mage.exe a MageUI.exe

    Mage.exe a MageUI.exe jsou součástí sady Windows Software Development Kit (SDK). Musíte mít nainstalovanou sadu Windows SDK nebo verzi sady Windows SDK, která je součástí sady Visual Studio. Další informace naleznete v tématu Windows SDK na webu MSDN.

  • Zadejte aplikaci, která se má nasadit.

    Tento názorný postup předpokládá, že máte aplikaci pro Windows, kterou jste připraveni nasadit. Tato aplikace se bude označovat jako AppToDeploy.

  • Určete, jak bude nasazení distribuováno.

    Mezi možnosti distribuce patří: Web, sdílená složka nebo DISK CD. Další informace naleznete v tématu ClickOnce Zabezpečení a nasazení.

  • Určete, jestli aplikace vyžaduje zvýšenou úroveň důvěryhodnosti.

    Pokud vaše aplikace vyžaduje úplný vztah důvěryhodnosti , například úplný přístup k systému uživatele, můžete tuto možnost Mage.exe nastavit-TrustLevel. Pokud chcete definovat vlastní sadu oprávnění pro vaši aplikaci, můžete zkopírovat část oprávnění k internetu nebo intranetu z jiného manifestu, upravit ji tak, aby vyhovovala vašim potřebám, a přidat ji do manifestu aplikace pomocí textového editoru nebo MageUI.exe. Další informace naleznete v tématu Přehled nasazení důvěryhodné aplikace.

  • Získejte certifikát Authenticode.

    Nasazení byste měli podepsat certifikátem Authenticode. Testovací certifikát můžete vygenerovat pomocí sady Visual Studio, MageUI.exenebo MakeCert.exe nástrojů Pvk2Pfx.exe nebo můžete získat certifikát od certifikační autority (CA). Pokud se rozhodnete použít nasazení důvěryhodné aplikace, musíte také provést jednorázovou instalaci certifikátu na všechny klientské počítače. Další informace naleznete v tématu Přehled nasazení důvěryhodné aplikace.

    Poznámka:

    Nasazení můžete také podepsat certifikátem CNG, který můžete získat od certifikační autority.

  • Ujistěte se, že aplikace nemá manifest s informacemi o řízení uživatelských účtů.

    Musíte určit, jestli vaše aplikace obsahuje manifest s informacemi řízení uživatelských účtů (UAC), jako <dependentAssembly> je například prvek. K prozkoumání manifestu aplikace můžete použít nástroj Windows Sysinternals Sigcheck .

    Pokud vaše aplikace obsahuje manifest s podrobnostmi nástroje Řízení uživatelských účtů, musíte ho znovu sestavit bez informací o řízení uživatelských účtů. V případě projektu jazyka C# v sadě Visual Studio otevřete vlastnosti projektu a vyberte kartu Aplikace. V rozevíracím seznamu Manifest vyberte Vytvořit aplikaci bez manifestu. V případě projektu jazyka Visual Basic v sadě Visual Studio otevřete vlastnosti projektu, vyberte kartu Aplikace a klikněte na Zobrazit nastavení nástroje Řízení uživatelských účtů. V otevřeném souboru manifestu odeberte všechny prvky v rámci jednoho <asmv1:assembly> elementu.

  • Určete, jestli aplikace vyžaduje požadavky na klientském počítači.

    Aplikace ClickOnce nasazené ze sady Visual Studio můžou do nasazení zahrnout spouštěcí nástroj pro instalaci požadovaných součástí (setup.exe). Tento názorný postup vytvoří dva manifesty potřebné pro nasazení ClickOnce. Požadovaný bootstrapper můžete vytvořit pomocí úlohy GenerateBootstrapper.

Nasazení aplikace pomocí nástroje příkazového řádku Mage.exe

  1. Vytvořte adresář, do kterého budete ukládat soubory nasazení ClickOnce.

  2. V adresáři nasazení, který jste právě vytvořili, vytvořte podadresář verze. Pokud aplikaci nasazujete poprvé, pojmenujte podadresář verze 1.0.0.0.

    Poznámka:

    Verze nasazení se může lišit od verze aplikace.

  3. Zkopírujte všechny soubory aplikace do podadresáře verzí, včetně spustitelných souborů, sestavení, prostředků a datových souborů. V případě potřeby můžete vytvořit další podadresáře, které obsahují další soubory.

  4. Otevřete sadu Windows SDK nebo příkazový řádek sady Visual Studio a přejděte do podadresáře verze.

  5. Vytvořte manifest aplikace s voláním Mage.exe. Následující příkaz vytvoří manifest aplikace pro kód zkompilovaný pro spuštění na procesoru Intel x86.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .

    Poznámka:

    Nezapomeňte za možnost zahrnout tečku (.), -FromDirectory která označuje aktuální adresář. Pokud tečku nezahrnete, musíte zadat cestu k souborům aplikace.

  6. Podepište manifest aplikace pomocí certifikátu Authenticode. Nahraďte mycert.pfx cestu k souboru certifikátu. Heslo pro soubor certifikátu nahraďte heslem.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd

    Počínaje sadou .NET Framework 4.6.2 SDK, která se distribuuje se sadou Visual Studio a se sadou Windows SDK, mage.exe podepíše manifesty pomocí CNG a také pomocí certifikátů Authenticode. Použijte stejné parametry příkazového řádku jako u certifikátů Authenticode.

  7. Přejděte do kořenového adresáře nasazení.

  8. Vygenerujte manifest nasazení s voláním Mage.exe. Ve výchozím nastavení Mage.exe označí vaše nasazení ClickOnce jako nainstalovanou aplikaci, aby bylo možné ji spustit online i offline. Pokud chcete aplikaci zpřístupnit pouze v případě, že je uživatel online, použijte -Install možnost s hodnotou false. Pokud použijete výchozí hodnotu a uživatelé nainstalují aplikaci z webu nebo sdílené složky, ujistěte se, že hodnota -ProviderUrl možnosti odkazuje na umístění manifestu aplikace na webovém serveru nebo sdílené složce.

    mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application

  9. Podepište manifest nasazení pomocí certifikátu Authenticode nebo CNG.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

  10. Zkopírujte všechny soubory v adresáři nasazení do cíle nasazení nebo média. Může se jednat o složku na webu nebo na serveru FTP, sdílené složce nebo cd-ROM.

  11. Poskytněte uživatelům adresu URL, UNC nebo fyzické médium potřebné k instalaci aplikace. Pokud zadáte adresu URL nebo UNC, musíte uživatelům poskytnout úplnou cestu k manifestu nasazení. Pokud je například AppToDeploy nasazen do http://webserver01/ adresáře AppToDeploy, úplná cesta URL by byla http://webserver01/AppToDeploy/AppToDeploy.application.

Nasazení aplikace pomocí grafického nástroje MageUI.exe

  1. Vytvořte adresář, do kterého budete ukládat soubory nasazení ClickOnce.

  2. V adresáři nasazení, který jste právě vytvořili, vytvořte podadresář verze. Pokud aplikaci nasazujete poprvé, pojmenujte podadresář verze 1.0.0.0.

    Poznámka:

    Verze vašeho nasazení se pravděpodobně liší od verze vaší aplikace.

  3. Zkopírujte všechny soubory aplikace do podadresáře verzí, včetně spustitelných souborů, sestavení, prostředků a datových souborů. V případě potřeby můžete vytvořit další podadresáře, které obsahují další soubory.

  4. MageUI.exe Spusťte grafický nástroj.

    MageUI.exe

  5. Vytvořte nový manifest aplikace tak, že v nabídce vyberete Soubor, Nový, Manifest aplikace.

  6. Na výchozí kartě Název zadejte název a číslo verze tohoto nasazení. Zadejte také procesor , pro který je vaše aplikace vytvořená, například pro x86.

  7. Vyberte kartu Soubory a pak vyberte tlačítko se třemi tečkou (...) vedle textového pole Adresář aplikace. Zobrazí se dialogové okno Procházet složku.

  8. Vyberte podadresář verze obsahující soubory aplikace a pak vyberte OK.

  9. Pokud nasadíte z Internetová informační služba (IIS), zaškrtněte políčko Při naplnění přidat příponu .deploy do libovolného souboru, který ho nemá.

  10. Přejděte na tlačítko Naplnit a přidejte do seznamu souborů všechny soubory vaší aplikace. Pokud vaše aplikace obsahuje více než jeden spustitelný soubor, označte hlavní spustitelný soubor pro toto nasazení jako spouštěcí aplikaci výběrem vstupního bodu z rozevíracího seznamu Typ souboru. (Pokud vaše aplikace obsahuje pouze jeden spustitelný soubor, MageUI.exe označí ho za vás.)

  11. Vyberte kartu Požadovaná oprávnění a vyberte úroveň důvěryhodnosti, kterou potřebujete k uplatnění aplikace. Výchozí hodnota je FullTrust, která bude vhodná pro většinu aplikací.

  12. V nabídce vyberte Soubor, Uložit jako . Zobrazí se dialogové okno Možnosti podepisování s výzvou k podepsání manifestu aplikace.

  13. Pokud máte certifikát uložený jako soubor ve vašem systému souborů, použijte možnost Podepsat se souborem certifikátu a vyberte certifikát ze systému souborů pomocí tlačítka se třemi tečkami (...). Pak zadejte heslo certifikátu.

    nebo

    Pokud je certifikát uložený v úložišti certifikátů přístupný z vašeho počítače, vyberte možnost Podepsat s uloženým certifikátem a vyberte certifikát ze zadaného seznamu.

  14. Pokud chcete podepsat manifest aplikace, vyberte OK . Zobrazí se dialogové okno Uložit jako.

  15. V dialogovém okně Uložit jako zadejte adresář verze a pak vyberte Uložit.

  16. V nabídce vyberte Soubor, Nový manifest nasazení a vytvořte manifest nasazení.

  17. Na kartě Název zadejte název a číslo verze pro toto nasazení (v tomto příkladu 1.0.0.0). Zadejte také procesor , pro který je vaše aplikace vytvořená, například pro x86.

  18. Vyberte kartu Popis a zadejte hodnoty pro Publisher a Product. (Produkt je název vaší aplikace ve Windows nabídka Start, když se aplikace nainstaluje do klientského počítače pro offline použití.)

  19. Vyberte kartu Možnosti nasazení a v textovém poli Počáteční umístění zadejte umístění manifestu aplikace na webovém serveru nebo sdílené složce. Například \\myServer\myShare\AppToDeploy.application.

  20. Pokud jste přidali příponu v předchozím kroku, vyberte zde také možnost Použít příponu .deploy názvu souboru .deploy.

  21. Vyberte kartu Možnosti aktualizace a určete, jak často se má tato aplikace aktualizovat. Pokud vaše aplikace používá UpdateCheckInfo ke kontrole samotných aktualizací, zrušte zaškrtnutí políčka Tato aplikace by měla zkontrolovat aktualizace .

  22. Vyberte kartu Reference k aplikaci a pak přejděte na tlačítko Vybrat manifest. Zobrazí se otevřené dialogové okno.

  23. Vyberte manifest aplikace, který jste vytvořili dříve, a pak vyberte Otevřít.

  24. V nabídce vyberte Soubor, Uložit jako . Zobrazí se dialogové okno Možnosti podepisování s výzvou k podepsání manifestu nasazení.

  25. Pokud máte certifikát uložený jako soubor ve vašem systému souborů, použijte možnost Podepsat se souborem certifikátu a vyberte certifikát ze systému souborů pomocí tlačítka se třemi tečkami (...). Pak zadejte heslo certifikátu.

    nebo

    Pokud je certifikát uložený v úložišti certifikátů přístupný z vašeho počítače, vyberte možnost Podepsat s uloženým certifikátem a vyberte certifikát ze zadaného seznamu.

  26. Pokud chcete podepsat manifest nasazení, přejděte na OK . Zobrazí se dialogové okno Uložit jako.

  27. V dialogovém okně Uložit jako přesuňte jeden adresář do kořenového adresáře nasazení a pak vyberte Uložit.

  28. Zkopírujte všechny soubory v adresáři nasazení do cíle nasazení nebo média. Může se jednat o složku na webu nebo na serveru FTP, sdílené složce nebo cd-ROM.

  29. Poskytněte uživatelům adresu URL, UNC nebo fyzické médium potřebné k instalaci aplikace. Pokud zadáte adresu URL nebo adresu UNC, musíte uživatelům poskytnout úplnou cestu manifestu nasazení. Pokud je například AppToDeploy nasazen do http://webserver01/ adresáře AppToDeploy, úplná cesta URL by byla http://webserver01/AppToDeploy/AppToDeploy.application.

Další kroky

Pokud potřebujete nasadit novou verzi aplikace, vytvořte nový adresář pojmenovaný po nové verzi , například 1.0.0.1, a zkopírujte nové soubory aplikace do nového adresáře. Dále musíte postupovat podle předchozích kroků k vytvoření a podepsání nového manifestu aplikace a aktualizaci a podepsání manifestu nasazení. Dávejte pozor, abyste v obou voláních Mage.exe -New -Update zadali stejnou vyšší verzi, protože ClickOnce aktualizuje pouze vyšší verze s nejvíce velkými čísly vlevo. Pokud jste použili MageUI.exe, můžete manifest nasazení aktualizovat tak, že ho otevřete, vyberete kartu Reference k aplikaci, přejdete na tlačítko Vybrat manifest a pak vyberete aktualizovaný manifest aplikace.

Související obsah