Zadání vlastností publikování ClickOnce

Vlastnosti publikování ClickOnce můžete nakonfigurovat na stránce Publikovat v 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 cesta k souboru nebo cesta k serveru FTP.

Vlastnost můžete zadat Publish Location na stránce Publikovat návrháře 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ík řešení, klikněte v nabídce Projekt na příkaz 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.

Určení umístění, odkud budou koncoví uživatelé instalovat

Při publikování aplikace ClickOnce nemusí být umístění, kam uživatelé přejdou stáhnout a nainstalovat aplikaci, nutně umístění, kam 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 Publikovat v 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ík řešení, klikněte v nabídce Projekt na příkaz 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čení offline nebo online režimu instalace ClickOnce

Aplikace Install Mode ClickOnce určuje, jestli bude aplikace dostupná offline nebo online. Pokud zvolíte Možnost Aplikace je dostupná jenom online, musí mít uživatel 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 bude moct aplikaci spustit, když nejsou připojeni.

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

Poznámka:

Můžete Install Mode ho 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ík řešení, klikněte v nabídce Projekt na příkaz 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ík řešení, klikněte v nabídce Projekt na příkaz 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 nabídky Přidat nebo odebrat programy v Ovládací panely.

Nastavení verze 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 Publikovat v Návrháři projektu.

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ík řešení, klikněte v nabídce Projekt 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á inkrementace verze publikování ClickOnce

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

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

Poznámka:

Dialogová okna a příkazy nabídek, které vidíte, se mohou lišit od těch popsaných v nápovědě v závislosti na aktivních nastaveních nebo edici. Pokud chcete změnit nastavení, zvolte Nastavení importu a exportu v nabídce Nástroje . Další informace najdete v tématu Resetování nastavení.

Zákaz automatického zvýšení verze publikování

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

  2. Klikněte na kartu Publikovat .

  3. V části Publikovat verzi zrušte zaškrtnutí políčka Automaticky zvýšit revizi s každou verzí.

Zadání stránky pro publikování aplikace 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 stránka publikování zadána, při příštím publikování se zkopíruje 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 Publikovat v Návrháři projektu.

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

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

  2. Vyberte podokno 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ík řešení, klikněte v nabídce Projekt na příkaz Vlastnosti.

  2. Vyberte podokno 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ánku Publish.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 změny projevili, budete muset upravit text požadovaného odkazu.

Přizpůsobení webové stránky publikování:

  1. Publikujte aplikaci ClickOnce do webového 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. Nepovinné. Pokud chcete sadě Visual Studio zabránit v přepsání přizpůsobené webové stránky publikování, zrušte zaškrtnutí políčka Automaticky generovat webovou stránku nasazení 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 Publikovat návrháře projektu.

Zadání adresy URL podpory:

  1. Pokud je projekt vybraný v Průzkumník řešení, klikněte v nabídce Projekt na příkaz 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 pro instalaci požadavků. 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.exe a MageUI.exe je možné 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í vašeho nasazení tak, aby zahrnoval 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.

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

  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. Pro předpoklad sestavení, které musí být předinstalováno v globální mezipaměti sestavení, nastavte supportUrl pro dependentAssembly prvek, 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. Nepovinné. 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 sady Mage.exe nebo MageUI.exe SDK, protože opětovné vygenerování těchto souborů pomocí sady Visual Studio vymaže vaš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í v rozhraní .NET Framework

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

Změna jazyka publikované aplikace ClickOnce

Při publikování aplikace ClickOnce se uživatelské rozhraní zobrazovalo během instalace ve výchozím nastavení jazyka a jazykové verze vývojového počítače. Pokud publikujete lokalizovanou aplikaci, budete muset zadat jazyk a jazykovou verzi, aby odpovídala 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 Publikovat v Návrháři projektu.

Poznámka:

Dialogová okna a příkazy nabídek, které vidíte, se mohou lišit od těch popsaných v nápovědě v závislosti na aktivních nastaveních nebo edici. Pokud chcete změnit nastavení, zvolte Nastavení importu a exportu v nabídce Nástroje . Další informace najdete v tématu Resetování nastavení.

Změna jazyka publikování:

  1. Pokud je projekt vybraný v Průzkumník řešení, klikněte v nabídce Projekt na příkaz 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ídka Start aplikace 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ánce publish.htm ; pro nainstalovanou offline aplikaci se zobrazí název položky v nabídce Start a bude to také název, který se zobrazí v nabídce Přidat nebo odebrat programy.

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

Nabídka Start zástupce nebo odkaz na aplikaci se vytvoří v %appdata%\Microsoft\Windows\Start Menu\Programs\<publisher name>. Odkaz na zástupce nebo aplikaci má stejný název 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 Publikovat v Návrháři projektů.

Zadání názvu nabídka Start:

  1. Pokud je projekt vybraný v Průzkumník řešení, klikněte v nabídce Projekt na příkaz 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.

AutoStartlze povolit na stránce Publikovat v Návrháři projektu.

Povolení automatického startu:

  1. Pokud je projekt vybraný v Průzkumník řešení, klikněte v nabídce Projekt 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 instalační program při vložení disku CD.

    Soubor Autorun.inf se zkopíruje do umístění publikování při publikování aplikace.