Utilizar el ejemplo de programa previo a Setup.exe con una aplicación

Actualización: noviembre 2007

Las operaciones realizadas por el ejemplo de arranque de Setup.exe son automáticas. Sin embargo, para permitir que Setup.exe utilice la aplicación se debe crear un archivo Settings.ini personalizado que incluya la información necesaria relativa a la aplicación. Además, se recomienda que implemente el programa de instalación con un archivo Léame en el que se indique a los usuarios los requisitos de configuración mínimos para instalar la aplicación y Dotnetfx.exe. En las siguientes secciones se incluye información detallada sobre la creación del archivo Settings.ini y el archivo Léame:

  • Crear un archivo Settings.ini

  • Crear un archivo Léame para el programa de instalación

Crear un archivo Settings.ini

En el ejemplo de arranque de Setup.exe se utiliza el archivo externo Settings.ini para determinar lo siguiente:

  • La ubicación de Dotnetfx.exe y de la aplicación host.

  • La versión de idioma de .NET Framework que hay que comprobar.

  • Las cadenas personalizadas que hay que utilizar en los cuadros de diálogo de Setup.exe.

La ubicación predeterminada de Settings.ini se encuentra en la misma carpeta que Setup.exe. El usuario es responsable de crear un archivo Settings.ini que permita al ejemplo de programa previo de Setup.exe para trabajar con la aplicación. Se puede copiar el archivo Settings.ini proporcionado con el ejemplo de programa previo a Setup.exe y, a continuación, modificar el archivo lo que haga falta para especificar los valores correctos para la aplicación.

Especificar la ubicación de Dotnetfx.exe y de la aplicación host.

En el ejemplo de arranque de Setup.exe es necesario que Dotnetfx.exe y la aplicación host de .NET Framework estén en una ubicación conocida relacionada con Setup.exe. En el ejemplo de arranque de Setup.exe se utiliza el archivo externo Settings.ini para determinar la ubicación de Dotnetfx.exe y la aplicación host. Puede copiar el archivo Settings.ini que se incluye en el ejemplo y editarlo después para seleccionar las ubicaciones de la aplicación host .NET Framework y de Dotnetfx.exe.

En los ejemplos siguientes de archivos Settings.ini, se muestra cómo se selecciona un paquete de Windows Installer para una aplicación host de .NET Framework (mySetup.msi) y Dotnetfx.exe en diversas ubicaciones relacionadas con la ubicación de Setup.exe.

En el ejemplo siguiente , el archivo Settings.ini, mySetup.msi y Dotnetfx.exe se encuentran en la misma carpeta que Setup.exe. Se utiliza un apóstrofo " ' " para escribir comentarios en las líneas que no están personalizadas.

[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

En el siguiente ejemplo, el archivo Settings.ini, mySetup.msi y Dotnetfx.exe se encuentran en un recurso compartido de red distinto de Setup.exe.

[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\

En el siguiente ejemplo, el archivo Settings.ini, mySetup.msi y Dotnetfx.exe se encuentran en el mismo equipo que Setup.exe, pero en carpetas diferentes.

[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\

En el siguiente ejemplo, el archivo Settings.ini, mySetup.msi y Dotnetfx.exe se encuentran en el mismo CD que Setup.exe, pero en carpetas diferentes.

[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/

Especificar la versión de idioma

Si desea que Setup.exe compruebe un número de compilación y la versión del idioma de .NET Framework, debe especificar el nombre de referencia cultural del idioma que hay que comprobar en el archivo Settings.ini. Si no se especifica un nombre de referencia cultural, Setup.exe busca la versión en idioma inglés de forma predeterminada.

En la tabla siguiente se enumeran las versiones de idioma disponibles y los correspondientes nombres de referencia cultural que hay que especificar en el archivo Settings.ini. En los nombres de referencia cultural no se distingue entre mayúsculas y minúsculas.

Idioma

Nombre de referencia cultural

Chino (Simplificado)

chs

Chino (Tradicional)

cht

Francés

fr

Alemán

de

Italiano

it

Japonés

ja

Coreano

ko

Español

es

En el ejemplo siguiente el archivo Settings.ini indica a Setup.exe que busque la versión en francés de Dotnetfx.exe.

[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Personalizar cadenas para los cuadros de diálogo de Setup.exe

Se pueden editar las siguientes variables en el archivo Settings.ini para personalizar cadenas que se muestran en los cuadros de diálogo de Setup.exe.

  • ProductName especifica el nombre de la aplicación de .NET Framework que Setup.exe va a instalar. El nombre de producto especificado se utiliza para personalizar el texto del cuadro de diálogo que aparece después de iniciar Setup.exe. Por ejemplo, si especifica Mi aplicación como ProductName, el cuadro de diálogo mostrará "Para iniciar la instalación de Mi aplicación, haga clic en Aceptar. Para salir sin instalar, haga clic en Cancelar"

    Si no personaliza la variable CaptionText, ProductName se utiliza también para personalizar la barra de título del cuadro de diálogo que aparece tras iniciar Setup.exe. Por ejemplo, si especifica Mi aplicación como ProductName, en la barra de título aparecerá "Instalación de Mi aplicación". Si personaliza ProductName and CaptionText, CaptionText se utiliza para personalizar el texto de la barra de título de este cuadro de diálogo.

    ProductName también se utiliza para personalizar el texto de la barra de título en el cuadro de diálogo que se muestra cuando la aplicación ha acabado de instalarse correctamente. Si no personaliza ProductName, se muestra el texto predeterminado "Instalación de la aplicación".

  • DialogText especifica el texto personalizado que se va a mostrar en el cuadro de diálogo que aparece tras iniciar Setup.exe. Si no personaliza DialogText, se muestra el texto predeterminado "Para iniciar la instalación de la aplicación, haga clic en Aceptar. Para salir sin instalar, se muestra haga clic en Cancelar"

  • CaptionText especifica el texto personalizado que se va a mostrar en la barra de título del cuadro de diálogo que aparece tras iniciar Setup.exe. Si no personaliza CaptionText, se muestra ProductName. Si no se personaliza ProductName, se muestra el texto predeterminado, "Instalación de la aplicación".

  • ErrorCaptionText especifica el texto personalizado que se muestra en la barra de título de los cuadros de diálogo de error de Setup.exe. Si no personaliza ErrorCaptionText, se muestra el texto predeterminado "Error de instalación de la aplicación".

Crear un archivo Léame para el programa de instalación

Se recomienda que el programa de instalación se distribuya con un archivo Léame en el que se enumeren los requisitos mínimos de configuración del equipo necesarios para que el programa de instalación pueda ejecutarse correctamente. Como mínimo, muestra Microsoft Windows 98 o posterior con Internet Explorer 5.01 o posterior instalado como requisito previo a la instalación. También se debería mostrar Microsoft Data Access Components (MDAC) versión 2.6 o posterior, pues, aunque no es necesario para la instalación, sí es necesario para las aplicaciones de .NET Framework que incluyen accesos a datos. Para obtener más información sobre los requisitos mínimos de configuración para instalar Dotnetfx.exe, vea Requisitos mínimos de configuración.

Vea también

Conceptos

Crear un único proyecto de instalación para instalar una aplicación de .NET Framework y Dotnetfx.exe

Operaciones de ejemplo del programa previo a Setup.exe

Requisitos mínimos de configuración para Dotnetfx.exe

Otros recursos

Redistribuir.NET Framework

  • Last updated on