Sdílet prostřednictvím


Zadání vlastností publikování ClickOnce

Vlastnosti publikování ClickOnce můžete nakonfigurovat na stránce Publikovatv Návrháři projektu nebo pomocí Průvodce publikováním. V tomto článku se dozvíte, jak zadat vlastnosti, jako je umístění publikování, adresa URL instalace, online nebo offline režim instalace a verze publikování.

Poznámka:

V clickOnce pro .NET Core 3.1 a .NET 5 nebo novější nastavíte vlastnosti nasazení pomocí nástroje Publikovat místo průvodce publikováním a stránky Publikovat v Návrháři projektů. Další informace naleznete v tématu Nasazení aplikace .NET pro Windows pomocí Technologie ClickOnce a ClickOnce pro .NET.

Určení umístění publikování

Když publikujete aplikaci pomocí ClickOnce, vlastnost určuje umístění, Publish Location kam jsou vloženy soubory aplikace a manifest. Může to být cestou k jednotce (C:\deploy\myapplication), sdílení souborů (\\server\myapplication) nebo server FTP (ftp://ftp.microsoft.com/myapplication). Všimněte si, že text musí být v poli Umístění publikování k dispozici, aby tlačítko procházet (...) fungovalo.

Vlastnost Publish Location můžete zadat na stránce Publikovat v Návrháři projektu nebo pomocí Průvodce publikováním. Další informace naleznete v tématu Postupy: Publikování aplikace ClickOnce pomocí Průvodce publikováním.

Poznámka:

Při instalaci více než jedné verze aplikace pomocí ClickOnce se instalace přesune starší verze aplikace do složky s názvem Archiv v umístění publikování, které zadáte. Archivace starších verzí tímto způsobem zachová instalační adresář složek z předchozí verze.

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. Do pole Publikovat umístění zadejte umístění publikování pomocí jednoho z následujících formátů:

    • Pokud chcete publikovat sdílenou složku nebo cestu k disku, zadejte cestu UNC (\\Server\ApplicationName) nebo cestu k souboru (C:\Deploy\ApplicationName).

    • Pokud chcete publikovat na server FTP, zadejte cestu pomocí formátu ftp://ftp.microsoft.com/<ApplicationName>.

      Všimněte si, že text musí být v poli Umístění publikování , aby tlačítko Procházet (...) fungovalo.

Zadejte umístění, ze kterého se budou koncoví uživatelé instalovat.

Při publikování aplikace ClickOnce nemusí být místo, kde si uživatelé aplikaci stahují a instalují, totožné s místem, kde aplikaci původně publikujete. Například v některých organizacích může vývojář publikovat aplikaci na přípravný server a pak správce aplikaci přesune na webový server.

V takovém případě můžete vlastnost použít Installation URL k určení webového serveru, na kterém uživatelé přejdou ke stažení aplikace. To je nezbytné, aby manifest aplikace věděl, kde hledat aktualizace.

Vlastnost Installation URL lze nastavit na stránce Publikovatv Návrháři projektu.

Poznámka:

Vlastnost Installation URL lze také nastavit pomocí PublishWizard. Další informace naleznete v tématu Postupy: Publikování aplikace ClickOnce pomocí Průvodce publikováním.

Zadání adresy URL instalace

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. Do pole Adresa URL instalace zadejte umístění instalace pomocí plně kvalifikované adresy URL ve formátu https://www.contoso.com/ApplicationNamenebo cestu UNC ve formátu \Server\ApplicationName.

Určete offline nebo online režim instalace ClickOnce

Určení Install Mode pro aplikaci ClickOnce určuje, zda bude aplikace dostupná offline nebo online. Pokud zvolíte Aplikace je dostupná pouze online, uživatel musí mít přístup k umístění publikování ClickOnce (webová stránka nebo sdílená složka), aby mohl aplikaci spustit. Když zvolíte Možnost Aplikace je dostupná i offline, aplikace přidá položky do nabídky Start a dialogové okno Přidat nebo odebrat programy ; uživatel může aplikaci spustit, když není připojený.

Install Mode se nastavit na stránce Publikovatv Návrháři projektu.

Poznámka:

Můžete Install Mode také nastavit pomocí průvodce publikováním. Další informace naleznete v tématu Postupy: Publikování aplikace ClickOnce pomocí Průvodce publikováním.

Zpřístupnění aplikace ClickOnce pouze online

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. V oblasti Režim instalace a Nastavení klikněte na tlačítko Možnosti Pouze online aplikace .

Zpřístupnění aplikace ClickOnce online nebo offline

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. V oblasti Režim instalace a Nastavení klikněte na tlačítko Možnosti Aplikace je k dispozici offline.

    Po instalaci aplikace přidá položky do nabídky Start a do ovládacích panelů Přidat nebo odebrat programy .

Nastavte verzi publikování ClickOnce

Vlastnost ClickOnce Publish Version určuje, zda bude aplikace, kterou publikujete, považována za aktualizaci. Pokaždé, když se zvýší verze, aplikace se publikuje jako aktualizace.

Vlastnost Publish Version lze nastavit na stránce Publikovatv Návrháři projektu.

Při změně čísla verze se aplikace publikuje jako aktualizace. Každá část verze publikování (hlavní,podverze, sestavení, revize) může mít maximální hodnotu 65535 (MaxValue), maximální povolenou Versionhodnotou .

Při instalaci více než jedné verze aplikace pomocí ClickOnce se instalace přesune starší verze aplikace do složky s názvem Archiv v umístění publikování, které zadáte. Archivace starších verzí tímto způsobem zachová instalační adresář složek z předchozí verze.

Poznámka:

Existuje možnost projektu, která automaticky zvýší Publish Version vlastnost při každém publikování aplikace. Tato možnost je ve výchozím nastavení povolená. Další informace naleznete v tématu Automatické zvýšení verze publikování ClickOnce.

Změna verze publikování

  1. Pokud je projekt vybraný v Průzkumníku řešení, v nabídce Projekt klikněte na Příkaz Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. V poli Publikovat verzi navyšte čísla hlavní verze, Podverze, Sestavení nebo Revize .

    Poznámka:

    Nikdy byste neměli dekrementovat číslo verze; může to způsobit nepředvídatelné chování aktualizace.

Automatické zvyšování publikovací verze ClickOnce

Při publikování aplikace ClickOnce změna Publish Version vlastnosti způsobí publikování aplikace jako aktualizace. Visual Studio automaticky ve výchozím nastavení zvýší Revision číslo Publish Version při každém publikování aplikace.

Toto chování můžete zakázat na stránce Publikovatnávrháře projektu.

Poznámka:

Zobrazená dialogová okna a příkazy nabídek se můžou lišit od těch, které jsou popsány v nápovědě, v závislosti na aktivním nastavení nebo edici. Pokud chcete změnit nastavení, zvolte Nastavení importu a exportu v nabídce Nástroje. Další informace naleznete v tématu resetování nastavení.

Zakázat automatické zvýšení verze vydání

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. V části Publikovat verzi zrušte zaškrtnutí políčka Automaticky zvýšit revizi s každým vydáním.

Zadání stránky publikování pro aplikaci ClickOnce

Při publikování aplikace ClickOnce se společně s aplikací vygeneruje a publikuje výchozí webová stránka (publish.htm). Tato stránka obsahuje název aplikace, odkaz na instalaci aplikace nebo jakékoli požadavky a odkaz na téma nápovědy popisující ClickOnce. Vlastnost Publikovat stránku projektu umožňuje zadat název webové stránky pro aplikaci ClickOnce.

Jakmile bude publikační stránka zadána, při dalším publikačním procesu bude zkopírována do umístění publikování; pokud publikujete znovu, nepřepíše se. Pokud chcete přizpůsobit vzhled stránky, můžete to udělat bez obav o ztrátu změn. Další informace naleznete v tématu Přizpůsobení výchozí webové stránky ClickOnce.

Vlastnost Publikovat stránku lze nastavit v dialogovém okně Možnosti publikování , přístupné z podokna Publikovatv Návrháři projektu.

Zadání vlastní webové stránky pro aplikaci ClickOnce:

  1. Pokud je projekt vybraný v Průzkumníku řešení, v nabídce Projekt klikněte na Příkaz Vlastnosti.

  2. Vyberte panel Publikovat.

  3. Kliknutím na tlačítko Možnosti otevřete dialogové okno Možnosti publikování .

  4. Klikněte na Nasazení.

  5. V dialogovém okně Možnosti publikování se ujistěte, že je zaškrtnuto políčko Otevřít webovou stránku nasazení po publikování (ve výchozím nastavení by měla být vybraná).

  6. Do pole Webová stránka Nasazení zadejte název webové stránky a klepněte na tlačítko OK.

Pokud chcete zabránit spuštění stránky publikování při každém publikování:

  1. Pokud je projekt vybraný v Průzkumníku řešení, v nabídce Projekt klikněte na Příkaz Vlastnosti.

  2. Vyberte panel Publikovat.

  3. Kliknutím na tlačítko Možnosti otevřete dialogové okno Možnosti publikování .

  4. Klikněte na Nasazení.

  5. V dialogovém okně Možnosti publikování zrušte zaškrtnutí políčka Otevřít webovou stránku nasazení po publikování .

Přizpůsobení výchozí webové stránky pro aplikaci ClickOnce

Při publikování aplikace ClickOnce na webu se webová stránka automaticky vygeneruje a publikuje společně s aplikací. Výchozí stránka obsahuje název aplikace a odkazy na instalaci aplikace, požadavky na instalaci nebo nápovědu k přístupu na webu MSDN.

Poznámka:

Skutečné odkazy, které vidíte na stránce, závisí na počítači, na kterém se stránka zobrazuje, a na požadavcích, které zahrnete.

Výchozí název webové stránky je Publish.htm; název můžete změnit v Návrháři projektu. Další informace naleznete v tématu Zadání stránky publikování aplikace ClickOnce.

Webová stránka Publish.htm se publikuje jenom v případě, že se zjistí novější verze.

Poznámka:

Změny provedené v nastavení publikování nebudou mít vliv na stránkuPublish.htm s jednou výjimkou: pokud po počátečním publikování přidáte nebo odeberete požadované součásti, seznam požadavků už nebude přesný. Abyste odráželi změny, budete muset upravit text pro požadovaný odkaz.

Pro přizpůsobení publikační stránky:

  1. Publikujte aplikaci ClickOnce na webové umístění. Další informace naleznete v tématu Postupy: Publikování aplikace ClickOnce pomocí Průvodce publikováním.

  2. Na webovém serveru otevřete soubor Publish.htm ve Visual Web Designeru nebo jiném editoru HTML.

  3. Upravte stránku podle potřeby a uložte ji.

  4. Volitelný. Pokud chcete zabránit sadě Visual Studio v přepsání vámi přizpůsobené publikační webové stránky, zrušte zaškrtnutí políčka Automaticky generovat webovou stránku publikování po každém publikování v dialogovém okně Možnosti publikování.

Při publikování aplikace ClickOnce vlastnost Adresa URL podpory identifikuje webovou stránku nebo sdílenou složku, kde uživatelé mohou získat informace o aplikaci. Tato vlastnost je nepovinná; v případě zadání se adresa URL zobrazí v dialogovém okně Přidat nebo odebrat programy aplikace.

Vlastnost Adresa URL podpory lze nastavit na stránce Publikovatnávrháře projektu.

Zadání adresy URL podpory:

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. Kliknutím na tlačítko Možnosti otevřete dialogové okno Možnosti publikování .

  4. Klikněte na Popis.

  5. Do pole Adresa URL podpory zadejte plně kvalifikovanou cestu k webu, webové stránce nebo sdílené složce UNC.

Zadání adresy URL podpory pro jednotlivé požadavky v nasazení ClickOnce

Nasazení ClickOnce může testovat řadu požadavků, které musí být k dispozici v klientském počítači, aby aplikace ClickOnce běžela. Mezi tyto závislosti patří požadovaná minimální verze rozhraní .NET Framework, verze operačního systému a všechna sestavení, která musí být předinstalována v globální mezipaměti sestavení (GAC). ClickOnce však nemůže nainstalovat žádný z těchto požadavků sám; pokud se požadovaný požadavek nenajde, jednoduše zastaví instalaci a zobrazí dialogové okno s vysvětlením, proč instalace selhala.

Existují dvě metody instalace předpokladů. Můžete je nainstalovat pomocí aplikace bootstrapperu. Alternativně můžete zadat adresu URL podpory pro jednotlivé požadavky, která se zobrazí uživatelům v dialogovém okně, pokud se požadovaný požadavek nenajde. Stránka odkazovaná adresou URL může obsahovat odkazy na pokyny pro instalaci požadovaných požadavků. Pokud aplikace neurčí adresu URL podpory pro jednotlivé požadavky, clickOnce zobrazí adresu URL podpory zadanou v manifestu nasazení pro aplikaci jako celek, pokud je definovaná.

Visual Studio, Mage.exea MageUI.exe lze použít ke generování nasazení ClickOnce, žádné z těchto nástrojů přímo nepodporují určení adresy URL podpory pro jednotlivé požadavky. Tento dokument popisuje, jak upravit manifest aplikace a manifest nasazení tak, aby zahrnovaly tyto adresy URL podpory.

Poznámka:

V clickOnce pro .NET Core 3.1 a .NET 5 nebo novější nastavíte vlastnosti nasazení pomocí nástroje Publikovat místo průvodce publikováním a stránky Publikovat v Návrháři projektů. Další informace naleznete v tématu Nasazení aplikace .NET pro Windows pomocí Technologie ClickOnce a ClickOnce pro .NET.

Zadejte URL adresu podpory pro jednotlivý předpoklad

  1. Otevřete manifest aplikace (soubor .manifest ) pro aplikaci ClickOnce v textovém editoru.

  2. Pro předpoklad operačního systému přidejte supportUrl atribut do elementu dependentOS :

     <dependency>
        <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
          <osVersionInfo>
            <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
          </osVersionInfo>
        </dependentOS>
      </dependency>
    
  3. Pro předpoklad pro určitou verzi modulu CLR (Common Language Runtime) přidejte supportUrl atribut do dependentAssembly položky, která určuje závislost modulu CLR (Common Language Runtime):

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
          <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
        </dependentAssembly>
      </dependency>
    
  4. Jako požadavek pro sestavení, které musí být předinstalováno v globální mezipaměti sestavení, nastavte supportUrl prvku dependentAssembly, který určuje požadované sestavení:

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
          <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
        </dependentAssembly>
      </dependency>
    
  5. Volitelný. U aplikací, které cílí na rozhraní .NET Framework 4, otevřete manifest nasazení (soubor .application ) pro aplikaci ClickOnce v textovém editoru.

  6. Pro požadavek rozhraní .NET Framework 4 přidejte supportUrl atribut do elementu compatibleFrameworks :

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
      <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
      <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
    </compatibleFrameworks>
    
  7. Jakmile manifest aplikace změníte ručně, musíte znovu podepsat manifest aplikace pomocí digitálního certifikátu a pak aktualizovat a znovu podepsat manifest nasazení. K provedení této úlohy použijte nástroje sadyMage.exe nebo MageUI.exe SDK, protože opětovné vygenerování těchto souborů pomocí sady Visual Studio vymaže ruční změny. Další informace o použití Mage.exe k opětovnému podepsání manifestů najdete v tématu Postupy: Opětovné podepsání manifestů aplikace a nasazení.

Zabezpečení rozhraní .NET Framework

Adresa URL podpory se v dialogovém okně nezobrazí, pokud je aplikace nastavena ke spuštění v částečné důvěryhodnosti.

Poznámka:

V clickOnce pro .NET Core a .NET 5 nebo novější, částečná důvěryhodnost, která vyžaduje zabezpečení přístupu kódu, není podporována. V rozhraní .NET Framework není použití zabezpečení přístupu kódu osvědčeným postupem a nedoporučuje se.

Změna jazyka publikování pro aplikaci ClickOnce

Při publikování aplikace ClickOnce se uživatelské rozhraní během instalace zobrazuje ve výchozím jazyce a kultuře vývojového počítače. Pokud publikujete lokalizovanou aplikaci, budete muset zadat jazyk a kulturu, aby odpovídaly lokalizované verzi. Publish language Určuje to vlastnost vašeho projektu.

Publish language Vlastnost lze nastavit v dialogovém okně Možnosti publikování, přístupné ze stránky Publikovatv Návrháři projektu.

Poznámka:

Zobrazená dialogová okna a příkazy nabídek se můžou lišit od těch, které jsou popsány v nápovědě, v závislosti na aktivním nastavení nebo edici. Pokud chcete změnit nastavení, zvolte Nastavení importu a exportu v nabídce Nástroje. Další informace naleznete v tématu resetování nastavení.

Změna jazyka publikování:

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

    Poznámka:

    V clickOnce pro .NET Core 3.1 a .NET 5 nebo novější nastavíte vlastnosti nasazení pomocí nástroje Publikovat místo průvodce publikováním a stránky Publikovat v Návrháři projektů. Další informace naleznete v tématu Nasazení aplikace .NET pro Windows pomocí Technologie ClickOnce a ClickOnce pro .NET.

  3. Kliknutím na tlačítko Možnosti otevřete dialogové okno Možnosti publikování .

  4. Klikněte na Popis.

  5. V dialogovém okně Možnosti publikování vyberte jazyk a jazykovou verzi z rozevíracího seznamu Publikovat jazyk a klepněte na tlačítko OK.

Zadání názvu nabídky Start pro aplikaci ClickOnce

Když je aplikace ClickOnce nainstalována pro online i offline použití, přidá se položka do nabídky Start a seznam Přidat nebo odebrat programy . Ve výchozím nastavení je zobrazovaný název stejný jako název sestavení aplikace, ale zobrazovaný název můžete změnit nastavením Název produktu v dialogovém okně Možnosti publikování .

Název produktu se zobrazí na stráncepublish.htm ; pro nainstalovanou offline aplikaci bude název položky v nabídce Start a bude to také název, který se zobrazí v části Přidat nebo odebrat programy.

Název vydavatele se zobrazí na stráncepublish.htm nad názvem produktu a pro nainstalovanou offline aplikaci bude také název složky, která obsahuje ikonu aplikace v nabídce Start .

Zástupce nabídky Start nebo odkaz aplikace se vytvoří v %appdata%\Microsoft\Windows\Start Menu\Programs\<název vydavatele>. Název odkazu na zástupce nebo aplikaci je stejný jako název produktu.

Vlastnosti názvu produktu a názvu vydavatele můžete nastavit v dialogovém okně Možnosti publikování , které jsou k dispozici na stránce Publikovatv Návrháři projektů.

Určení názvu nabídky Start:

  1. Pokud je projekt vybraný v Průzkumníku řešení , vyberte v nabídce Projekt možnost Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. Kliknutím na tlačítko Možnosti otevřete dialogové okno Možnosti publikování .

  4. Klikněte na Popis.

  5. V dialogovém okně Možnosti publikování zadejte název, který se má zobrazit v názvu produktu.

  6. Volitelně můžete do názvu vydavatele zadat název vydavatele.

Povolení automatického startu pro instalace DISKŮ CD

Při nasazování aplikace ClickOnce pomocí vyměnitelného média, jako je CD-ROM nebo DVD-ROM, můžete povolit AutoStart , aby se aplikace ClickOnce automaticky spustila při vložení média.

AutoStart lze povolit na stránce Publikovatv Návrháři projektu.

Povolení automatického startu:

  1. Pokud je projekt vybraný v Průzkumníku řešení, v nabídce Projekt klikněte na Příkaz Vlastnosti.

  2. Klikněte na kartu Publikovat .

  3. Klikněte na tlačítko Možnosti .

    Zobrazí se dialogové okno Možnosti publikování .

  4. Klikněte na Nasazení.

  5. Zaškrtněte políčko Pro instalace CD automaticky spustit instalaci při vložení CD.

    Soubor Autorun.inf se zkopíruje do místa publikování při publikování aplikace.