Share via

Specificare un URL di supporto per i singoli prerequisiti in una distribuzione ClickOnce

  • Articolo

Una distribuzione ClickOnce può testare per diversi prerequisiti che devono essere disponibili nel computer client per l'esecuzione dell'applicazione ClickOnce. Queste dipendenze includono la versione minima richiesta di .NET Framework, la versione del sistema operativo e tutti gli assembly che devono essere preinstallati nella Global Assembly Cache (GAC). ClickOnce, tuttavia, non può installare nessuno di questi prerequisiti; se non viene trovato un prerequisito, l'installazione viene semplicemente interrotta e viene visualizzata una finestra di dialogo che spiega perché l'installazione non è riuscita.

Esistono due metodi per installare i prerequisiti. È possibile installarli usando un'applicazione del programma di avvio automatico. In alternativa, è possibile specificare un URL di supporto per i singoli prerequisiti, che viene visualizzato agli utenti nella finestra di dialogo se il prerequisito non viene trovato. La pagina a cui fa riferimento tale URL può contenere collegamenti a istruzioni per l'installazione del prerequisito richiesto. Se un'applicazione non specifica un URL di supporto per un singolo prerequisito, ClickOnce visualizza l'URL di supporto specificato nel manifesto della distribuzione per l'applicazione nel suo complesso, se definito.

Anche se Visual Studio, Mage.exe e MageUI.exe possono essere usati tutti per generare distribuzioni ClickOnce, nessuno di questi strumenti supporta direttamente la specifica di un URL di supporto per singoli prerequisiti. Questo documento descrive come modificare il manifesto dell'applicazione e il manifesto della distribuzione per includere questi URL di supporto.

Specificare un URL di supporto per un singolo prerequisito

  1. Aprire il manifesto dell'applicazione (il file manifesto ) per l'applicazione ClickOnce in un editor di testo.

  2. Per un prerequisito del sistema operativo, aggiungere l'attributo supportUrl all'elemento 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. Per un prerequisito per una determinata versione di Common Language Runtime, aggiungere l'attributo supportUrl alla dependentAssembly voce che specifica la dipendenza di 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. Per un prerequisito per un assembly che deve essere preinstallato nella Global Assembly Cache, impostare per l'elemento supportUrl che specifica l'assembly dependentAssembly necessario:

      <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. Facoltativo. Per le applicazioni destinate a .NET Framework 4, aprire il manifesto della distribuzione (il file dell'applicazione) per l'applicazione ClickOnce in un editor di testo.

  6. Per un prerequisito di .NET Framework 4, aggiungere l'attributo supportUrl all'elemento 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. Dopo aver modificato manualmente il manifesto dell'applicazione, è necessario firmare nuovamente il manifesto dell'applicazione usando il certificato digitale, quindi aggiornare e firmare nuovamente il manifesto della distribuzione. Usare gli strumenti Mage.exe o MageUI.exe SDK per eseguire questa attività, perché la rigenerazione di questi file tramite Visual Studio cancella le modifiche manuali. Per altre informazioni sull'uso di Mage.exe per firmare nuovamente i manifesti, vedere Procedura: Firmare nuovamente manifesti dell'applicazione e della distribuzione.

.NET Framework (sicurezza)

L'URL di supporto non viene visualizzato nella finestra di dialogo se l'applicazione è contrassegnata per l'esecuzione in attendibilità parziale.

Contenuto correlato