Podrobné pokyny: Ruční nasazení aplikace ClickOnce nevyžadující opětovné podepsání a zachovávající informace o výrobci

Článek
08/11/2011

Při vytváření ClickOnce aplikace a předání zákazníkovi k publikování a nasazení, měl tradičně zákazník aktualizovat manifest nasazení a znovu jej podepsat. Přesto, že je to stále upřednostňovanou metodou ve většině případů, .NET Framework 3.5 umožňuje vytvořit ClickOnce nasazení, které mohou být nasazeny zákazníkům bez nutnosti znovu vygenerovat nové manifesty nasazení. Další informace naleznete v tématu Nasazování aplikací ClickOnce pro testovací a výrobní servery bez opětovného podepisování.

Pokud vytváříte ClickOnce aplikaci a předáváte ji zákazníkovi k publikování a nasazení, aplikace může použít přidání údajů zákazníka nebo může zachovat vaše obchodní údaje. Například pokud je aplikace jednou speciální aplikací, můžete chtít zachovat vaše obchodní údaje. Pokud je aplikace vysoce přizpůsobena pro každého zákazníka, můžete chtít použít přidání údajů zákazníka. .NET Framework 3.5 umožňuje zachovat vaše obchodní údaje, informace o vydavateli a bezpečnostní signaturu, když dáváte aplikaci organizaci k nasazení. Další informace naleznete v tématu Vytváření aplikací ClickOnce pro ostatní k nasazení.

Poznámka

V tomto návodu vytváří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 Podrobné pokyny: Ruční nasazení aplikace ClickOnce.

Požadavky

Chcete-li dokončit postup tohoto návodu, potřebujete následující:

Aplikaci modelu Windows Forms, kterou jste připraveni nasadit. Tato aplikace bude označována jako WindowsFormsApp1.
Visual Studio nebo Windows SDK.

Pro nasazení aplikace ClickOnce s větší podporou nasazení a přidání údajů výrobce pomocí Mage.exe

Otevřete příkazový řádek programu Visual Studio nebo Windows SDK a změňte na adresář, ve kterém budete ukládat své ClickOnce soubory.
Vytvořte adresář s názvem po aktuální verzi vašeho nasazení. Pokud se jedná o první případ nasazení aplikace, pak pravděpodobně zvolíte 1.0.0.0.

Poznámka

Verze vašeho nasazení může být odlišná od verzí souborů aplikace.
Vytvořte podadresář s názvem koš a zkopírujte sem všechny soubory aplikace včetně spustitelných souborů, sestavení, zdrojů a datových souborů.

Vygenerujte manifest aplikace pomocí volání 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"

Podepište manifest aplikace pomocí vášeho digitálního certifikátu.
```
mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
```
Vygenerujte manifest nasazení s voláním Mage.exe. Ve výchozím nastavení označí Mage.exe vaše ClickOnce nasazení jako instalovanou aplikaci, takže ji lze spustit online i offline. Chcete-li, aby byla aplikace k dispozici pouze v případě, že uživatel je online, použijte argument -i s hodnotou f. Vzhledem k tomu, že tato aplikace bude využívat více funkcí nasazení, vylučte argument -providerUrl Mage.exe. (Ve verzích rozhraní .NET Framework před verzí 3.5, vyloučení -providerUrl offline aplikace způsobí chybu.)
```
mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest 
```
Nepodepisujte manifest nasazení.
Všechny soubory poskytněte zákazníkovi, který nasadí aplikaci ve své síti.
V tomto okamžiku musí zákazník podepsat manifest nasazení svým vlastním generovaným certifikátem. Například, pokud zákazník pracuje pro společnost s názvem Adventure Works, může generovat certifikát pomocí nástroje MakeCert.exe. Potom použije nástroj Pvk2pfx.exe pro seskupení souborů vytvořených pomocí 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
```
Tento certifikát zákazník dále používá k podepsání manifestu nasazení.
```
mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
```
Zákazník nasazuje aplikaci svým uživatelům.

Pro nasazení aplikace ClickOnce s větší podporou nasazení a přidání údajů výrobce pomocí MageUI.exe

Otevřete příkazový řádek programu Visual Studio nebo Windows SDK a přejděte na adresář, ve kterém budete ukládat své ClickOnce soubory.
Vytvořte podadresář s názvem koš a zkopírujte sem všechny soubory aplikace včetně spustitelných souborů, sestavení, zdrojů a datových souborů.
Vytvořte podadresář s názvem po aktuální verzi vašeho nasazení. Pokud se jedná o první případ nasazení aplikace, pak pravděpodobně zvolíte 1.0.0.0.

Poznámka

Verze vašeho nasazení může být odlišná od verzí souborů aplikace.
Přesuňte adresář koš do adresáře, který jste vytvořili v kroku 2.
Spusťte grafický nástroj MageUI.exe.
```
MageUI.exe
```
Vytvořit nové manifest aplikace výběrem Soubor, Nový, Manifest aplikace z nabídky.
Na výchozí záložce Název zadejte název a číslo verze tohoto nasazení. Zadejte také hodnota pro Vydavatel, která bude po nasazení použita jako název složky pro zástupce aplikace v nabídce Start.
Zvolte záložku Možnosti aplikace a klikněte na tlačítko Použít manifest aplikace pro informace o vztahu důvěryhodnosti. To umožní výrobcům třetích stran přidání vlastních údajů pro tuto ClickOnce aplikaci.
Zvolte záložku Soubory a klikněte na tlačítko Procházet vedle textového pole adresář aplikace.
Zvolte adresář, který obsahuje soubory aplikace, kterou jste vytvořili v kroku 2 a klikněte na tlačítko OK v dialogovém okně Výběr složky.
Klikněte na tlačítko Naplnit pro přidání všech souborů aplikace do seznamu souborů. Pokud aplikace obsahuje více než jeden spustitelný soubor, označte hlavní spustitelný soubor pro toto nasazení jako spouštěcí aplikaci volbou Vstupní bod z rozevíracího seznamu Typ souboru. (Pokud aplikace obsahuje pouze jeden spustitelný soubor, MageUI.exe ho označí za vás.)
Zvolte záložku Požadovaná oprávnění a zvolte úroveň vztahu důvěryhodnosti, kterou potřebujete k vyhodnocení aplikace. Výchozí hodnota je Úplný vztah důvěryhodnosti, která bude vhodná pro většinu aplikací.
Zvolte Soubor, Uložit z nabídky a uložte manifest aplikace. Budete vyzváni k podepsání manifestu aplikace při jeho ukládání.
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 zvolte certifikát pomocí tlačítka tři tečky (... ).

-nebo-

Pokud je váš certifikát veden v úložišti certifikátů, které je přístupné z vašeho počítače, zvolte Podepsat s uloženým certifikátem a zvolte certifikát z nabídnutého seznamu.
Zvolte Soubor, Nový, Manifest nasazení z nabídky pro vytvoření vašeho manifestu nasazení a potom na záložce Název zadejte název a číslo verze (1.0.0.0 v tomto příkladu).
Přejděte na záložku Aktualizace a určete, jak často chcete tuto aplikaci aktualizovat. Pokud aplikace používá rozhraní API ClickOnce nasazení pro vyhledání aktualizací, zrušte označení zaškrtávacího políčka Tato aplikace by měla zjišťovat aktualizace.
Přepněte na záložku Odkaz aplikace. Všechny hodnoty na této záložce můžete předem zadat kliknutím na tlačítko Zvolit manifest a výběrem manifestu aplikace vytvořeného v předchozích krocích.
Zvolte Uložit a uložte manifest nasazení na disk. Budete vyzváni k podepsání manifestu aplikace při jeho ukládání. Klikněte na tlačítko Storno pro uložení manifestu bez podepisování.
Všechny soubory aplikace poskytněte zákazníkovi.
V tomto okamžiku musí zákazník podepsat manifest nasazení svým vlastním generovaným certifikátem. Například, pokud zákazník pracuje pro společnost s názvem Adventure Works, může generovat certifikát pomocí nástroje MakeCert.exe. Potom použije nástroj Pvk2pfx.exe pro seskupení souborů vytvořených pomocí 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
```
S vygenerovaným certifikátem může nyní zákazník podepsat manifest nasazení otevřením manifestu nasazení v MageUI.exe a jeho uložením. Při zobrazení dialogového okna podepisování zákazník vybere možnost Podepsat jako soubor certifikátu a vybere soubor PFX, který uložil na disk.
Zákazník nasazuje aplikaci svým uživatelům.

Viz také

Odkaz

Mage.exe (Manifest Generation and Editing Tool)

MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)

Makecert.exe (Certificate Creation Tool)

Sdílet prostřednictvím