Návod: Ruční nasazení aplikace ClickOnce, která nevyžaduje opětovné podepisování a zachovává informace o brandingu

  • Článek

Když vytvoříte aplikaci ClickOnce a pak ji dáte zákazníkovi k publikování a nasazení, zákazník musel tradičně aktualizovat manifest nasazení a znovu ho podepsat. I když je to stále upřednostňovaná metoda ve většině případů, rozhraní .NET Framework 3.5 umožňuje vytvářet nasazení ClickOnce, která je možné nasadit zákazníky, aniž by museli znovu vygenerovat nový manifest nasazení. Další informace naleznete v tématu Nasazení aplikací ClickOnce pro testování a produkční servery bez rezignování.

Když vytvoříte aplikaci ClickOnce a pak ji dáte zákazníkovi k publikování a nasazení, může aplikace používat branding zákazníka nebo může zachovat vaši značku. Pokud je například aplikace jednou proprietární aplikací, můžete chtít zachovat branding. Pokud je aplikace pro každého zákazníka vysoce přizpůsobená, můžete použít branding zákazníka. Rozhraní .NET Framework 3.5 umožňuje zachovat branding, informace o vydavateli a podpis zabezpečení při nasazení aplikace organizaci. Další informace najdete v tématu Vytváření aplikací ClickOnce pro ostatní, které se mají nasadit.

Poznámka:

V tomto názorném postupu vytvoříte nasazení ručně pomocí nástroje příkazového řádku Mage.exe nebo grafického nástroje MageUI.exe. Další informace o ručních nasazeních naleznete v tématu Návod: Ruční nasazení aplikace ClickOnce.

Poznámka:

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

Požadavky

K provedení kroků v tomto názorném postupu potřebujete následující:

  • Aplikace model Windows Forms, kterou jste připraveni nasadit. Tato aplikace se bude označovat jako WindowsFormsApp1.

  • Visual Studio nebo Sada Windows SDK.

Nasazení aplikace ClickOnce s více nasazením a podporou brandingu pomocí Mage.exe

  1. Otevřete příkazový řádek sady Visual Studio nebo příkazový řádek sady Windows SDK a přejděte do adresáře, do kterého budete ukládat soubory ClickOnce.

  2. Vytvořte adresář pojmenovaný po aktuální verzi nasazení. Pokud aplikaci nasazujete poprvé, pravděpodobně zvolíte 1.0.0.0.

    Poznámka:

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

  3. Vytvořte podadresář s názvem bin a zkopírujte zde všechny soubory vaší aplikace, včetně spustitelných souborů, sestavení, prostředků a datových souborů.

  4. Vygenerujte manifest aplikace s voláním Mage.exe.

    mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"

  5. Podepište manifest aplikace pomocí digitálního certifikátu.

    mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx

  6. Vygenerujte manifest nasazení s voláním Mage.exe. Mage.exe ve výchozím nastavení označí vaše nasazení ClickOnce jako nainstalovanou aplikaci, aby bylo možné spustit online i offline. Pokud chcete aplikaci zpřístupnit pouze v případě, že je uživatel online, použijte -i argument s hodnotou f. Vzhledem k tomu, že tato aplikace bude využívat více funkcí nasazení, vylučte -providerUrl argument Mage.exe. (Ve verzích rozhraní .NET Framework před verzí 3.5, s výjimkou -providerUrl offline aplikace dojde k chybě.)

    mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest

  7. Nepodepisujte manifest nasazení.

  8. Poskytněte zákazníkovi všechny soubory, které aplikaci nasadí do své sítě.

  9. V tomto okamžiku musí zákazník podepsat manifest nasazení svým vlastním certifikátem vygenerovaným vlastním certifikátem. Pokud například zákazník pracuje pro společnost s názvem Adventure Works, může vygenerovat certifikát podepsaný svým držitelem pomocí nástroje MakeCert.exe . Dále pomocí nástroje Pvk2pfx.exe zkombinujte soubory vytvořené MakeCert.exe do souboru PFX, který lze předat Mage.exe.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx

  10. Zákazník pak tento certifikát použije k podepsání manifestu nasazení.

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx

  11. Zákazník nasadí aplikaci svým uživatelům.

Nasazení aplikace ClickOnce s více nasazením a podporou brandingu pomocí MageUI.exe

  1. Otevřete příkazový řádek sady Visual Studio nebo příkazový řádek sady Windows SDK a přejděte do adresáře, do kterého budete ukládat soubory ClickOnce.

  2. Vytvořte podadresář s názvem bin a zkopírujte zde všechny soubory vaší aplikace, včetně spustitelných souborů, sestavení, prostředků a datových souborů.

  3. Vytvořte podadresář pojmenovaný podle aktuální verze nasazení. Pokud aplikaci nasazujete poprvé, pravděpodobně zvolíte 1.0.0.0.

    Poznámka:

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

  4. Přesuňte adresář \bin do adresáře, který jste vytvořili v kroku 2.

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

    MageUI.exe

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

  7. Na výchozí kartě Název zadejte název a číslo verze tohoto nasazení. Zadejte také hodnotu pro Publisher, která se použije jako název složky pro odkaz na zástupce aplikace v nabídka Start při nasazení.

  8. Vyberte kartu Možnosti aplikace a klikněte na Použít manifest aplikace pro informace o důvěryhodnosti. Tím povolíte branding třetích stran pro tuto aplikaci ClickOnce.

  9. Vyberte kartu Soubory a klikněte na tlačítko Procházet vedle textového pole Adresář aplikací.

  10. Vyberte adresář, který obsahuje soubory aplikace, které jste vytvořili v kroku 2, a klepněte na tlačítko OK v dialogovém okně pro výběr složky.

  11. Kliknutím na tlačítko Naplnit přidejte všechny soubory aplikace do seznamu souborů. 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 ji označí za vás.)

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

  13. Vyberte Soubor, Uložit z nabídky a uložte manifest aplikace. Při uložení se zobrazí výzva k podepsání manifestu aplikace.

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

    nebo

    Pokud je váš certifikát uložený v úložišti certifikátů, ke kterému máte přístup z počítače, vyberte možnost Podepsat s uloženým certifikátem a ze seznamu vyberte certifikát.

  15. V nabídce vyberte Soubor, Nový, Manifest nasazení a pak na kartě Název zadejte název a číslo verze (1.0.0.0.0 v tomto příkladu ).

  16. Přepněte na kartu Aktualizace a určete, jak často se má tato aplikace aktualizovat. Pokud vaše aplikace používá rozhraní API pro nasazení ClickOnce ke kontrole samotných aktualizací, zrušte zaškrtnutí políčka Označená tato aplikace by měla vyhledat aktualizace.

  17. Přepněte na kartu Reference k aplikaci. Všechny hodnoty na této kartě můžete předem naplnit kliknutím na tlačítko Vybrat manifest a výběrem manifestu aplikace, který jste vytvořili v předchozích krocích.

  18. Zvolte Uložit a uložit manifest nasazení na disk. Při uložení se zobrazí výzva k podepsání manifestu aplikace. Kliknutím na tlačítko Storno uložte manifest bez podepsání.

  19. Poskytněte zákazníkovi všechny soubory aplikace.

  20. V tomto okamžiku musí zákazník podepsat manifest nasazení svým vlastním certifikátem vygenerovaným vlastním certifikátem. Pokud například zákazník pracuje pro společnost s názvem Adventure Works, může vygenerovat certifikát podepsaný svým držitelem pomocí nástroje MakeCert.exe . Dále pomocí nástroje Pvk2pfx.exe zkombinujte soubory vytvořené MakeCert.exe do souboru PFX, který lze předat MageUI.exe.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx

  21. Po vygenerovaném certifikátu teď zákazník podepíše manifest nasazení otevřením manifestu nasazení v mageUI.exe a jeho uložením. Když se zobrazí dialogové okno podepisování, zákazník vybere možnost Podepsat jako soubor certifikátu a zvolí soubor PFX, který uložil na disk.

  22. Zákazník nasadí aplikaci svým uživatelům.

Související obsah