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

  • Článek
  • 4 min ke čtení

pokud nemůžete použít Visual Studio k nasazení ClickOnce aplikace nebo potřebujete použít pokročilé funkce nasazení, jako je například nasazení důvěryhodné aplikace, měli byste použít nástroj Mage.exe příkazového řádku k vytvoření ClickOnce manifestů. Tento návod popisuje, jak vytvořit ClickOnce nasazení pomocí buď verze příkazového řádku (Mage.exe), nebo grafické verze (MageUI.exe) Manifest Generation and Editing Tool.

Požadavky

Tento návod obsahuje některé předpoklady a možnosti, které je třeba vybrat před sestavením nasazení.

  • Nainstalujte Mage.exe a MageUI.exe.

    Mage.exe a MageUI.exe jsou součástí Windows Software Development Kit (SDK) . Musíte mít Sada SDK pro Windows nainstalovánu nebo verzi Sada SDK pro Windows zahrnutou v Visual Studio. další informace najdete v tématu Windows SDK na webu MSDN.

  • Poskytněte aplikaci, která se má nasadit.

    tento návod předpokládá, že máte aplikaci Windows, kterou jste připraveni nasadit. Tato aplikace bude označována jako AppToDeploy.

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

    Mezi možnosti distribuce patří: web, sdílení souborů nebo CD. další informace najdete v tématu ClickOnce Security and Deployment.

  • Určete, zda 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 -TrustLevel k nastavení použít možnost Mage.exe . Pokud chcete pro svou aplikaci definovat vlastní sadu oprávnění, můžete zkopírovat část oprávnění Internet nebo intranet 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 najdete v tématu Přehled nasazení důvěryhodných aplikací.

  • Získejte certifikát Authenticode.

    Své nasazení byste měli podepsat pomocí certifikátu Authenticode. testovací certifikát můžete vygenerovat pomocí Visual Studio, MageUI.exe nebo MakeCert.exe a Pvk2Pfx.exech nástrojů, 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 do všech klientských počítačů. Další informace najdete v tématu Přehled nasazení důvěryhodných aplikací.

    Poznámka

    Nasazení můžete taky podepsat pomocí certifikátu CNG, který můžete získat od certifikační autority.

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

    Musíte určit, jestli vaše aplikace obsahuje manifest s informacemi o nástroji Řízení uživatelských účtů (UAC), jako je například <dependentAssembly> element. chcete-li prostudovat manifest aplikace, můžete použít nástroj Windows sysinternals Sigcheck .

    Pokud vaše aplikace obsahuje manifest s podrobnostmi o nástroji Řízení uživatelských účtů, je nutné ji znovu sestavit bez informací o nástroji Řízení uživatelských účtů. pro projekt C# v Visual Studio otevřete vlastnosti projektu a vyberte kartu aplikace. V rozevíracím seznamu manifest vyberte možnost vytvořit aplikaci bez manifestu. pro projekt Visual Basic v Visual Studio otevřete vlastnosti projektu, vyberte kartu aplikace a klikněte na tlačítko zobrazit nástroj řízení uživatelských účtů Nastavení. 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.

    ClickOnceaplikace nasazené z Visual Studio můžou do nasazení zahrnovat nezbytný zaváděcí nástroj pro instalaci (setup.exe). Tento návod vytvoří dva manifesty, které jsou požadovány pro ClickOnce nasazení. Potřebný zaváděcí nástroj 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 ClickOnce soubory nasazení.

  2. V adresáři nasazení, který jste právě vytvořili, vytvořte podadresář verze. Pokud se jedná o první nasazení aplikace, pojmenujte podadresář verze 1.0.0.0.

    Poznámka

    Verze vašeho nasazení může být odlišná od verze vaší aplikace.

  3. Zkopírujte všechny soubory vaší aplikace do podadresáře Version, 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 příkazový Sada SDK pro Windows řádek nebo 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ý ke spuštění na procesorech Intel x86.

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

    Poznámka

    Nezapomeňte zahrnout tečku (.) po -FromDirectory Možnosti, která označuje aktuální adresář. Pokud neuvedete tečku, musíte zadat cestu k souborům aplikace.

  6. Podepište manifest aplikace pomocí certifikátu Authenticode. Nahraďte mycert. pfx cestou k souboru certifikátu. Nahraďte passwd heslem k souboru certifikátu.

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

    počínaje sadou .NET Framework 4.6.2 SDK, která je distribuována s Visual Studio a Windows SDK, mage.exe podepíší manifesty s CNG i s certifikáty Authenticode. Používejte stejné parametry příkazového řádku jako u certifikátů Authenticode.

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

  8. Vygenerujte manifest nasazení s voláním Mage.exe. Ve výchozím nastavení Mage.exe označí ClickOnce nasazení jako nainstalovanou aplikaci, aby mohla běžet online i offline. Pokud chcete, aby byla aplikace dostupná jenom v případě, že je uživatel online, použijte -Install možnost s hodnotou false . Použijete-li výchozí nastavení a uživatelé budou instalovat 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ílového umístění nebo na médium nasazení. Může to být složka na webu nebo serveru FTP, sdílená složka nebo jednotka CD-ROM.

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

Nasazení aplikace pomocí nástroje MageUI.exe Graphics Tool

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

  2. V adresáři nasazení, který jste právě vytvořili, vytvořte podadresář verze. Pokud se jedná o první nasazení aplikace, pojmenujte podadresář verze 1.0.0.0.

    Poznámka

    Verze vašeho nasazení je pravděpodobně odlišná od verze vaší aplikace.

  3. Zkopírujte všechny soubory vaší aplikace do podadresáře Version, 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. Spusťte grafický nástroj MageUI.exe .

    MageUI.exe

  5. Vytvořte nový manifest aplikace výběrem položky soubor, Nový a manifest aplikace z nabídky.

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

  7. Vyberte kartu soubory a potom klikněte na tlačítko se třemi tečkami (...) vedle textového pole adresář aplikace . Zobrazí se dialogové okno Vyhledat 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 po naplnění přidat příponu. deploy do libovolného souboru, který toto pole nemá.

  10. Chcete-li přidat všechny soubory aplikace do seznamu souborů, použijte tlačítko naplnit . Pokud vaše aplikace obsahuje více než jeden spustitelný soubor, označte hlavní spustitelný soubor pro toto nasazení jako spouštěcí aplikaci tak, že vyberete vstupní bod v rozevíracím seznamu typ souboru . (Pokud vaše aplikace obsahuje jenom jeden spustitelný soubor, MageUI.exe bude označovat za vás.)

  11. Vyberte kartu požadovaná oprávnění a vyberte úroveň důvěryhodnosti, kterou budete potřebovat k vyhodnocení vaší 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í, které vás vyzve k podepsání manifestu aplikace.

  13. Pokud máte certifikát uložený jako soubor v 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 váš certifikát uložený v úložišti certifikátů, které je dostupné z vašeho počítače, vyberte možnost podepsat s uloženým certifikátem a vyberte certifikát ze seznamu poskytnutých.

  14. Vyberte OK pro podepsání manifestu aplikace. 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 svůj manifest nasazení.

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

  18. vyberte kartu popis a zadejte hodnoty pro Publisher a produkt. (produkt je název daný vaší aplikaci na Windows nabídka Start při instalaci aplikace do klientského počítače pro použití v režimu offline.)

  19. Vyberte kartu Možnosti nasazení a v textovém poli Začátek 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 v předchozím kroku přidali rozšíření . deploy , vyberte zde také možnost použít. nasadit příponu názvu souboru .

  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 aktualizací sám sebe, zrušte zaškrtnutí políčka Tato aplikace by měla kontrolovat aktualizace .

  22. Vyberte kartu odkaz na aplikaci a pak přejít na tlačítko Vybrat manifest . Zobrazí se dialogové okno otevřít.

  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í , které vás vyzve k podepsání manifestu nasazení.

  25. Pokud máte certifikát uložený jako soubor v 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 váš certifikát uložený v úložišti certifikátů, které je dostupné z vašeho počítače, vyberte možnost podepsat s uloženým certifikátem a vyberte certifikát ze seznamu poskytnutých.

  26. Pro podepsání manifestu nasazení použijte tlačítko 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ílového umístění nebo na médium nasazení. Může to být složka na webu nebo serveru FTP, sdílená složka nebo jednotka CD-ROM.

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

Další kroky

Pokud potřebujete nasadit novou verzi aplikace, vytvořte nový adresář s názvem po nové verzi (třeba 1.0.0.1) a zkopírujte nové soubory aplikace do nového adresáře. Dále je nutné postupovat podle předchozích kroků k vytvoření a podepsání nového manifestu aplikace a aktualizaci a podepsání manifestu nasazení. Buďte opatrní, abyste zadali stejnou vyšší verzi v Mage.exe -New i -Update voláních, a to jenom v případě, že ClickOnce aktualizujete novější verze s nejnižším celým číslem, které je nejvíce vlevo. Pokud jste použili MageUI.exe, můžete manifest nasazení aktualizovat otevřením, výběrem karty odkaz na aplikaci , přechodem na tlačítko Vybrat manifest a následným výběrem aktualizovaného manifestu aplikace.

Viz také