GenerateBootstrapper (tarea)

  • Artículo

Proporciona una forma automatizada de detectar, descargar e instalar una aplicación y sus requisitos previos. Actúa como instalador único que integra los instaladores independientes de todos los componentes que forman una aplicación.

Parámetros de tareas

A continuación se describen los parámetros de la tarea GenerateBootstrapper.

  • ApplicationFile

    Parámetro String opcional.

    Especifica el archivo que utilizará el programa previo para iniciar la instalación de la aplicación una vez instalados 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 va a instalar el programa previo. Este nombre aparecerá en la interfaz de usuario que el programa previo utiliza durante la instalación.

  • ApplicationRequiresElevation

    Parámetro Boolean opcional.

    Si 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 que hospeda el instalador de la aplicación.

  • BootstrapperComponentFiles

    Parámetro de salida String[] opcional.

    Especifica la ubicación generada de los archivos de paquete de programa previo.

  • BootstrapperItems

    Parámetro ITaskItem[] opcional.

    Especifica los productos que se van a compilar en el programa previo. Los elementos pasados a este parámetro deben tener la sintaxis siguiente:

    <BootstrapperItem
    Include="ProductCode">
    <ProductName>
        ProductName
    </ProductName>
</BootstrapperItem>

    El atributo Include representa el nombre de un requisito previo que debe estar instalado. Los metadatos del elemento ProductName son opcionales, y el motor de compilación los usa como un nombre descriptivo en caso de que no se encuentre el paquete. Estos elementos no son parámetros de entrada de MSBuild requeridos, salvo que no se especifique ningún ApplicationFile. Debe 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 en que el programa previo va a buscar 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 está en la misma ubicación que la aplicación.

    • Absolute: indica que todos los componentes deben encontrarse en una dirección URL centralizada. Este valor debe utilizarse junto con el parámetro de entrada ComponentsUrl.

      Si ComponentsLocation no se especifica, HomeSite se utiliza de forma predeterminada.

  • ComponentsUrl

    Parámetro String opcional.

    Especifica la dirección URL que contiene los requisitos previos de instalación.

  • CopyComponents

    Parámetro Boolean opcional.

    Si true, el programa previo 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 basarse en esta ruta de acceso. Si false, los archivos no se copian y los valores de 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 utilizará para la interfaz de usuario del programa previo y los requisitos previos de instalación. Si la referencia cultural especificada no está disponible, la tarea usa el valor del parámetro FallbackCulture.

  • FallbackCulture

    Parámetro String opcional.

    Especifica la referencia cultural secundaria que se usa para la interfaz de usuario del programa previo y los requisitos previos de instalación.

  • OutputPath

    Parámetro String opcional.

    Especifica la ubicación en la que se va a 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 si se produce un error en la instalación del programa previo.

  • Validate

    Parámetro Boolean opcional.

    Si true, el programa previo realiza una validación XSD en los elementos del programa previo 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 a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte TaskExtension base class.

Ejemplo

En el ejemplo siguiente se usa la tarea GenerateBootstrapper para instalar una aplicación que debe tener .NET Framework 2.0 instalado como requisito previo.

<Project xmlns="http://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