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: <BootstrapperItem Include=”ProductCode”> <ProductName> ProductName </ProductName> </BootstrapperItem> 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: HomeSite: Indica que el proveedor del componente aloja el requisito previo. Relative: Indica que requisito previo se encuentra en la misma ubicación que la aplicación. Absolute: Indica que todos los componentes se encuentran en una dirección URL centralizada. Este valor debería utilizarse junto con el parámetro de entrada ComponentsUrl. 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>

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild