GenerateBootstrapper (Tarea)

  • Artículo

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 arranque 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 compilació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 arranque instalará. Este nombre aparecerá en la interfaz de usuario que el arranque utiliza durante la instalación.

ApplicationRequiresElevation

Parámetro Boolean opcional.

Si es true, el componente se ejecuta con permisos elevados cuando se instala en un equipo de destino.

ApplicationUrl

Parámetro String opcional.

Especifica la ubicación Web en la que se hospeda el instalador de la aplicación.

BootstrapperComponentFiles

Parámetro de salida String[] opcional.

Especifica la ubicación de compilación de archivos de paquete del arranque.

BootstrapperItems

Parámetro ITaskItem[] opcional.

Especifica los productos que se deben compilar en el arranque. 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 compilació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 compilación si no se especifican los parámetros BootstrapperItems ni ApplicationFile.

BootstrapperKeyFile

Parámetro de salida String opcional.

Especifica la ubicación de compilación de setup.exe

ComponentsLocation

Parámetro String opcional.

Especifica una ubicación para que el arranque 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 hospeda el requisito previo.

  • Relative: indica que el 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 arranque copia todos los archivos de salida 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 arranque 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 arranque 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 arranque

Validate

Parámetro Boolean opcional.

Si es true, el arranque realiza la validación de XSD para los elementos de arranque de entrada especificados. El valor predeterminado de este parámetro es false.

Comentarios

Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension (Clase base).

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