Cómo: Especificar una dirección URL de soporte para requisitos previos individuales en una implementación de ClickOnce
Actualización: noviembre 2007
Como se describe en Requisitos previos para la implementación de aplicaciones, una implementación de ClickOnce puede comprobar varios requisitos previos que deben estar disponibles en el equipo cliente para que la aplicación ClickOnce se ejecute. Éstos incluyen la versión mínima necesaria de .NET Framework, la versión del sistema operativo y cualquier ensamblado que deba estar preinstalado en la caché de ensamblados global (GAC). Sin embargo, ClickOnce no puede instalar ninguno de estos requisitos previos por sí mismo; si no se encuentra un requisito previo, simplemente detiene la instalación y muestra un cuadro de diálogo que explica por qué se produjo un error en la instalación.
Hay dos métodos para instalar los requisitos previos. Tal como se explica en el documento mencionado anteriormente, puede instalarlos mediante una aplicación del programa previo. Opcionalmente, puede especificar una dirección URL de soporte para los requisitos previos individuales, que se muestra a los usuarios en el cuadro de diálogo si no se encuentra el requisito previo. La página a la que hace referencia esa dirección URL puede contener vínculos a las instrucciones para instalar el requisito previo necesario. Si una aplicación no especifica una dirección URL de soporte para un requisito previo individual, ClickOnce muestra la dirección URL de soporte especificada en el manifiesto de implementación para la aplicación en conjunto, si se define.
Mientras Visual Studio, Mage.exe y MageUI.exe pueden utilizarse para generar las implementaciones de ClickOnce, ninguna de estas herramientas admite directamente que se especifique una dirección URL de soporte para los requisitos previos individuales. En este documento se describe cómo modificar el manifiesto de aplicación de implementación para incluir las direcciones URL de soporte.
Especificar una dirección URL de soporte para un requisito previo individual
Abra el manifiesto de la aplicación ClickOnce en un editor de texto.
Para un requisito previo del sistema operativo, agregue el atributo supportUrl al 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>Para un requisito previo para una versión determinada de Common Language Runtime, agregue el atributo supportUrl a la entrada dependentAssembly que especifica la dependencia de 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>Para un requisito previo para un ensamblado que se debe preinstalar en la caché de ensamblados global, establezca supportUrl para el elemento dependentAssembly que especifica el ensamblado necesario:
<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>Cuando ha modificado manualmente el manifiesto de aplicación, debe volver a firmar el manifiesto de aplicación mediante el certificado digital; a continuación, vuelva a crear y firmar también el manifiesto de implementación. Debe utilizar las herramientas del SDK de Mage.exe o MageUI.exe para realizar esta tarea, ya que si vuelve a crear estos archivos mediante Visual Studio, se borran los cambios manuales. Para obtener más información sobre cómo utilizar MageUI.exe para firmar y generar manifiestos, vea Herramienta de generación y edición de manifiestos (Mage.exe) y Tutorial: Implementar manualmente una aplicación ClickOnce.
Seguridad
La dirección URL de soporte no se muestra en el cuadro de diálogo si la aplicación se marca para ejecutarse en confianza parcial.