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

  • Článek

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 definována.

Zatímco Visual Studio, Mage.exe a 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í vašeho nasazení tak, aby zahrnoval tyto adresy URL podpory.

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 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ů naleznete v tématu Postupy: Opětovné podepsání aplikace a manifesty nasazení.

zabezpečení v rozhraní .NET Framework

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

Související obsah