GenerateBootstrapper (Tarea)
Actualización: noviembre 2007
Proporciona una manera automatizada de detectar, descargar e instalar una aplicación y sus requisitos previos. Actúa como instalador único que integra los instaladores independientes para todos los componentes que constituyen una aplicación.
Parámetros de la tarea
En la siguiente tabla se describen los parámetros de la tarea GenerateBootstrapper.
Parámetro |
Descripción |
---|---|
ApplicationFile |
Parámetro String opcional. Especifica el archivo que el programa previo utilizará para comenzar la instalación de la aplicación después de que se hayan instalado todos los requisitos previos. Se producirá un error de generación si no se especifican los parámetros BootstrapperItems ni ApplicationFile. |
ApplicationName |
Parámetro String opcional. Especifica el nombre de la aplicación que el programa previo instalará. Este nombre aparecerá en la interfaz de usuario que el programa previo utiliza durante la instalación. |
ApplicationUrl |
Parámetro String opcional. Especifica la ubicación Web en la que se aloja el instalador de la aplicación. |
BootstrapperComponentFiles |
Parámetro de salida String[] opcional. Especifica la ubicación de generación de archivos de paquete del programa previo. |
BootstrapperItems |
Parámetro ITaskItem[] opcional. Especifica los productos que se deben generar en el programa previo. Los elementos que se pasan a este parámetro deberían tener la sintaxis siguiente:
El atributo Include se utiliza para representar el nombre de un requisito previo que se debería instalar. Los metadatos del elemento ProductName son opcionales y serán utilizados por el motor de generación como nombre descriptivo si no se encuentra el paquete. Estos elementos no son parámetros de entrada de MSBuild necesarios, a menos que no se especifique ApplicationFile. Debería incluir un elemento para cada requisito previo que se deba instalar para la aplicación. Se producirá un error de generación si no se especifican los parámetros BootstrapperItems ni ApplicationFile. |
BootstrapperKeyFile |
Parámetro de salida String opcional. Especifica la ubicación de generación de setup.exe |
ComponentsLocation |
Parámetro String opcional. Especifica una ubicación para que el programa previo busque los requisitos previos de instalación que se deben instalar. Este parámetro puede tener los valores siguientes:
Si no se especifica ComponentsLocation, se utiliza HomeSite de manera predeterminada. |
ComponentsUrl |
Parámetro String opcional. Especifica la dirección URL que contiene los requisitos previos para la instalación. |
CopyComponents |
Parámetro Boolean opcional. Si es true, el programa previo copia todos los archivos de resultados en la ruta de acceso especificada en el parámetro OutputPath. Todos los valores del parámetro BootstrapperComponentFiles deben estar basados en esta ruta de acceso. Si es false, no se copian los archivos, y los valores BootstrapperComponentFiles se basan en el valor del parámetro Path. El valor predeterminado de este parámetro es true. |
Culture |
Parámetro String opcional. Especifica la referencia cultural que se debe utilizar para la Interfaz de usuario del programa previo y los requisitos previos para la instalación. Si la referencia cultural especificada no está disponible, la tarea utiliza el valor del parámetro FallbackCulture. |
FallbackCulture |
Parámetro String opcional. Especifica la referencia cultural secundaria que se debe utilizar para la interfaz de usuario del programa previo y los requisitos previos para la instalación. |
OutputPath |
Parámetro String opcional. Especifica la ubicación en la que se deben copiar setup.exe y todos los archivos de paquete. |
Path |
Parámetro String opcional. Especifica la ubicación de todos los paquetes de requisitos previos disponibles. |
SupportUrl |
Parámetro String opcional. Especifica la dirección URL que se debe proporcionar en caso de error de instalación del programa previo |
Validate |
Parámetro Boolean opcional. Si es true, el programa previo realiza la validación de XSD para los elementos de programa previo de entrada especificados. El valor predeterminado de este parámetro es false. |
Ejemplo
En el siguiente ejemplo se utiliza la tarea GenerateBootstrapper para instalar una aplicación que debe tener instalado .NET Framework 2.0 como requisito previo.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<BootstrapperFile Include="Microsoft.Net.Framework.2.0">
<ProductName>Microsoft .NET Framework 2.0</ProductName>
</BootstrapperFile>
</ItemGroup>
<Target Name="BuildBootstrapper">
<GenerateBootstrapper
ApplicationFile="WindowsApplication1.application"
ApplicationName="WindowsApplication1"
ApplicationUrl="http://mycomputer"
BootstrapperItems="@(BootstrapperFile)"
OutputPath="C:\output" />
</Target>
</Project>