Procedura: specificare un URL di supporto per i singoli prerequisiti in una distribuzione ClickOnce
Aggiornamento: novembre 2007
Come descritto in Prerequisiti per la distribuzione dell'applicazione, è possibile che in una distribuzione ClickOnce vengano verificati alcuni prerequisiti che devono essere disponibili nel computer client per l'esecuzione dell'applicazione ClickOnce. Tra questi prerequisiti sono inclusi la versione minima di .NET Framework richiesta, la versione del sistema operativo ed eventuali assembly che devono essere preinstallati nella Global Assembly Cache (GAC). Questi prerequisiti tuttavia non possono essere installati da ClickOnce. Se manca un prerequisito, l'installazione viene arrestata e viene visualizzata una finestra di dialogo in cui viene spiegato il motivo dell'interruzione dell'installazione.
I prerequisiti possono essere installati in due modi. Come descritto nel documento sopra citato, è possibile installarli utilizzando un'applicazione del programma di avvio automatico. In alternativa, è possibile specificare un URL di supporto per i singoli prerequisiti che verrà visualizzato nella finestra di dialogo qualora il prerequisito non sia disponibile. Nella pagina a cui fa riferimento l'URL possono essere contenuti collegamenti a istruzioni di installazione del prerequisito richiesto. Se non viene specificato un URL di supporto per un singolo prerequisito, in ClickOnce verrà visualizzato l'URL di supporto eventualmente specificato nel manifesto di distribuzione dell'intera applicazione.
Benché sia possibile utilizzare Visual Studio, Mage.exe e MageUI.exe per generare distribuzioni di ClickOnce, nessuno di questi strumenti supporta direttamente la specifica di URL di supporto per singoli prerequisiti. In questo documento viene descritto come modificare il manifesto dell'applicazione della distribuzione in modo da includere gli URL di supporto.
Specifica di un URL di supporto per un singolo prerequisito
Aprire il manifesto dell'applicazione di ClickOnce in un editor di testo.
Per indicare come prerequisito un sistema operativo specifico, aggiungere l'attributo supportUrl all'elemento dependentOS:
<dependency> <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm"> <osVersionInfo> <os majorVersion="4" minorVersion="0" servicePackMajor="0" servicePackMinor="0" /> </osVersionInfo> </dependentOS> </dependency>Per indicare come prerequisito una determinata versione di Common Language Runtime, aggiungere l'attributo supportUrl alla voce dependentAssembly 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="2.0.40607.0" /> </dependentAssembly> </dependency>Per indicare come prerequisito un assembly che deve essere preinstallato nella Global Assembly Cache, impostare l'attributo supportUrl per l'elemento dependentAssembly che specifica l'assembly richiesto:
<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>Dopo aver modificato manualmente il manifesto dell'applicazione, è necessario firmarlo di nuovo utilizzando il certificato digitale e quindi generare e firmare di nuovo anche il manifesto di distribuzione. A tale scopo, utilizzare lo strumento dell'SDK Mage.exe o MageUI.exe, poiché rigenerando questi file con Visual Studio le modifiche manuali vengono annullate. Per ulteriori informazioni sull'utilizzo di MageUI.exe per firmare e generare manifesti, vedere Strumento per la generazione e la modifica di manifesti (Mage.exe) e Procedura dettagliata: distribuzione manuale di un'applicazione ClickOnce.
Sicurezza
L'URL di supporto non verrà visualizzato nella finestra di dialogo se l'applicazione è contrassegnata per essere eseguita in condizioni di attendibilità parziale.