Podrobné pokyny: Ruční nasazení aplikace ClickOnce

Článek
08/11/2011

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

Požadavky

Tento návod obsahuje některé požadavky a možnosti, které je třeba zvolit před vytvořením nasazení.

Instalovat Mage.exe a MageUI.exe.

Mage.exe a MageUI.exe jsou součástí Windows Software Development Kit (SDK). Musíte mít buď nainstalovanou Windows SDK nebo verzi Windows SDK součástí aplikace Visual Studio. Další informace naleznete v Windows sdk na webu MSDN.
Poskytnutí aplikace pro nasazení.

Tento návod předpokládá, že máte aplikaci pro systém Windows připravenou k nasazení. Tato aplikace bude označována jako AppToDeploy.
Určete jak bude nasazení distribuováno.

Možnosti distribuování zahrnují: Web, sdílená síťová složka nebo CD. Další informace naleznete v tématu ClickOnce zabezpečení a nasazení.
Zjistěte, zda aplikace vyžaduje zvýšenou úroveň vztahu důvěryhodnosti.

Jestliže aplikace požaduje plný vztah důvěryhodnosti – například plný přístup k systému uživatele – můžete použít možnost -TrustLevel Mage.exe k jejímu nastavení. Pokud chcete definovat vlastní sadu oprávnění pro aplikaci, můžete z jiného manifestu zkopírovat oddíl oprávnění sítí Internet nebo intranet a upravit jej tak, aby odpovídal vašim potřebám a přidat jej do manifestu aplikace buď pomocí textového editoru nebo MageUI.exe. Další informace naleznete v tématu Důvěryhodný přehled nasazení aplikace.
Získejte certifikát technologie Authenticode.

Vaše nasazení byste měli podepsat pomocí certifikátu technologie Authenticode. Je možné generovat zkušební certifikát pomocí nástrojů Visual Studio, MageUI.exe nebo MakeCert.exe a Pvk2Pfx.exe nebo je možné certifikát získat od certifikačního úřadu (CA). Pokud se rozhodnete používat důvěryhodné nasazení aplikace, je nutné také provést jednorázovou instalaci certifikátu na všechny klientské počítače. Další informace naleznete v tématu Důvěryhodný přehled nasazení aplikace.
Přesvědčte se, zda aplikace nemá manifest s informacemi nástroje Řízení uživatelských účtů.

Potřebujete zjistit, zda aplikace obsahuje manifest s informacemi nástroje Řízení uživatelských účtů (UAC), jako je například prvek <dependentAssembly>. Zkontrolujte manifest aplikace můžete použít Windows Sysinternals Sigcheck nástroj.

Pokud aplikace obsahuje manifest s podrobnostmi nástroje Řízení uživatelských účtů, musíte jej znovu sestavit bez informací o nástroji Řízení uživatelských účtů. U C# projektu ve Visual Studiu otevřete vlastnosti projektu a zvolte záložku Aplikace. V rozevíracím seznamu Manifest zvolte Vytvořit aplikaci bez manifestu. U projektu Visual Basic ve Visual Studiu otevřete vlastnosti projektu, zvolte záložku 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 prvku <asmv1:assembly>.
Zjistěte, zda aplikace vyžaduje požadavky na klientském počítači.

ClickOnce aplikace nasazené z aplikace Visual Studio mohou zahrnovat zaváděcí nástroj požadavků instalace (setup.exe) s nasazením. Tento návod vytvoří dva manifesty požadované pro nasazení ClickOnce. Můžete vytvořit zaváděcí nástroj požadavků pomocí GenerateBootstrapper úloha.

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

Vytvořte adresář, kde budete ukládat své soubory nasazení ClickOnce.
V adresáři nasazení, který jste právě vytvořili, vytvořte podadresář verze. Pokud nasazujete aplikaci poprvé, nazvěte podadresář verze 1.0.0.0.

Poznámka

Verze vašeho nasazení může být odlišná od verze vaší aplikace.
Zkopírujte všechny soubory aplikace do podadresáře verze včetně spustitelných souborů, sestavení, zdrojů a datových souborů. V případě potřeby můžete vytvořit další podadresáře, které obsahují další soubory.
Otevřete Windows SDK nebo příkazový řádek Visual Studia a změňte podadresář verze.
Vytvořte manifest aplikace pomocí volání Mage.exe. Následující výpis vytvoří manifest aplikace pro kód zkompilovaný pro 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 po tečku (.) za možnost -FromDirectory, která označuje aktuální adresář. Pokud nezadáte tečku, je nutné zadat cestu k souborům aplikace.
Podepište manifest aplikace pomocí vášeho digitálního certifikátu Authenticode. Nahraďte mycert.pfx cestou k souboru vašeho certifikátu. Nahraďte passwd heslem pro váš soubor certifikátu.
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
Přejděte do kořenu adresáře nasazení.
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 možnost -Install s hodnotou false. Pokud používáte výchozí nastavení a uživatelé budou instalovat aplikaci z webového serveru nebo sdílené síťové složky, ujistěte se, zda hodnota možnosti -ProviderUrl odkazuje na umístění manifestu aplikace na webovém serveru nebo ve 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
```
Podepište manifest nasazení pomocí vašeho digitálního certifikátu Authenticode.
```
mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
```
Zkopírujte všechny soubory z adresáře nasazení do cíle nasazení nebo na médium. To může být buď složka na webu nebo FTP server, sdílená síťová složka nebo CD-ROM.
Uživatelům poskytněte adresu URL, název cesty UNC nebo fyzické médium, které jsou potřebné k instalaci aplikace. Zadáte-li URL nebo název cesty UNC, je třeba uživatelům zadat úplnou cestu k manifestu nasazení. Například pokud je AppToDeploy nasazena na http://webserver01/ v adresáři AppToDeploy, úplná cesta URL by měla být http://webserver01/AppToDeploy/AppToDeploy.application.

Pro nasazení aplikace grafickým nástrojem MageUI.exe

Vytvořte adresář, kde budete ukládat své soubory nasazení ClickOnce.
V adresáři nasazení, který jste právě vytvořili, vytvořte podadresář verze. Pokud nasazujete aplikaci poprvé, nazvěte podadresář verze 1.0.0.0.

Poznámka

Verze vašeho nasazení je pravděpodobně odlišná od verzí souborů aplikace.
Zkopírujte všechny soubory aplikace do podadresáře verze včetně spustitelných souborů, sestavení, zdrojů a datových souborů. V případě potřeby můžete vytvořit další podadresáře, které obsahují další soubory.
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í. Také určete Procesor, pro který je vaše aplikace sestavena, jako je například x86.
Zvolte záložku Soubory a klikněte na tlačítko "tři tečky" (...) vedle textového pole Adresář aplikace. Zobrazí se dialogové okno Vyhledat složku.
Zvolte podadresář verze obsahující soubory aplikace a klikněte na tlačítko OK.
Pokud budete nasazovat z Internetové informační služby (IIS), zvolte zaškrtávací políčko Po vyplnění přidat příponu .deploy ke každému souboru, který ji nemá.
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 FullTrust, která bude vhodná pro většinu aplikací.
V nabídce Soubor vyberte příkaz Uložit jako. Zobrazí se dialogové okno Možnosti podepisování s výzvou k podepsání manifestu aplikace.
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 zvolte certifikát pomocí tlačítka tři tečky (... ). Zadejte heslo certifikátu.

-nebo-

Pokud je váš certifikát veden v úložišti certifikátů, které je přístupné z vašeho počítače, zvolte možnost Podepsat s uloženým certifikátem a zvolte certifikát z nabídnutého seznamu.
Klikněte na tlačítko OK pro podepsání manifestu aplikace. Zobrazí se dialogové okno Uložit jako.
V dialogovém okně Uložit jako zadejte adresář verze a klikněte na tlačítko Uložit.
Zvolte Soubor, Nový, Manifest nasazení z nabídky pro vytvoření vašeho manifestu nasazení.
Na záložce Název zadejte název a číslo verze pro toto nasazení (1.0.0.0 v tomto příkladu). Také určete Procesor, pro který je vaše aplikace sestavena, jako je například x86.
Zvolte záložku Popis a zadejte hodnoty pro Vydavatel a Produkt. (Produktu je název aplikace v nabídce Start systému Windows při instalaci klientského počítače pro použití offline aplikace.)
Zvolte záložku Možnosti nasazení a v textovém poli Umístění spuštění určete umístění manifestu aplikace na webovém serveru nebo sdílené složce. Například \\myServer\myShare\AppToDeploy.application.
Pokud jste v předchozím kroku přidali příponu .deploy, také zde zvolte Použít příponu názvu souboru .deploy.
Zvolte záložku Možnosti aktualizace a určete, jak často chcete aktualizovat tuto aplikaci. Pokud aplikace používá UpdateCheckInfo pro vyhledání aktualizací samostatně, zrušte označení zaškrtávacího políčka Tato aplikace by měla zjišťovat aktualizace.
Zvolte záložku Odkaz aplikace a potom klikněte na tlačítko Zvolit manifest. Zobrazí se dialogové okno Otevřít.
Zvolte manifest aplikace, který jste vytvořili a potom klikněte na tlačítko Otevřít.
V nabídce Soubor vyberte příkaz Uložit jako. Zobrazí se dialogové okno Možnosti podepisování s výzvou k podepsání manifestu nasazení.
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 zvolte certifikát pomocí tlačítka tři tečky (... ). Zadejte heslo certifikátu.

-nebo-

Pokud je váš certifikát veden v úložišti certifikátů, které je přístupné z vašeho počítače, zvolte možnost Podepsat s uloženým certifikátem a zvolte certifikát z nabídnutého seznamu.
Klikněte na tlačítko OK pro podepsání manifestu nasazení. Zobrazí se dialogové okno Uložit jako.
V dialogovém okně Uložit jako se přesuňte nahoru do kořenového adresáře nasazení a klikněte na tlačítko Uložit.
Zkopírujte všechny soubory z adresáře nasazení do cíle nasazení nebo na médium. To může být buď složka na webu nebo FTP server, sdílená síťová složka nebo CD-ROM.
Uživatelům poskytněte adresu URL, název cesty UNC nebo fyzické médium, které jsou potřebné k instalaci aplikace. Zadáte-li adresu URL nebo název cesty UNC, je třeba uživatelům zadat úplnou cestu k manifestu nasazení. Například pokud je AppToDeploy nasazena na http://webserver01/ v adresáři AppToDeploy, úplná cesta URL by měla být http://webserver01/AppToDeploy/AppToDeploy.application.

Další kroky

Potřebujete-li nasadit novou verzi aplikace, vytvořte nový adresář s názvem po nové verzi – například 1.0.0.1 — a zkopírujte soubory nové 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í. Nezapomeňte zadat stejnou vyšší verzi v obou Mage.exe voláních -New a –Update, jako ClickOnce aktualizuje pouze vyšší verze s integerem nejvíce vlevo jako nejvýznamnějším. Pokud jste použili MageUI.exe, můžete manifest nasazení aktualizovat otevřením, výběrem záložky Odkaz aplikace kliknutím na tlačítko Zvolit manifest a výběrem aktualizovaného manifestu aplikace.