Tarea GenerateBootstrapper

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

Parámetros de tarea

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

• ApplicationFile

  Parámetro opcional String .

  Especifica el archivo que usará el programa previo para iniciar la instalación de la aplicación una vez instalados todos los requisitos previos. Si no se especifica ni el BootstrapperItems parámetro ni el ApplicationFile parámetro , se producirá un error de compilación.

• ApplicationName

  Parámetro opcional String .

  Especifica el nombre de la aplicación que instalará el programa previo. Este nombre aparecerá en la interfaz de usuario que usa el programa previo durante la instalación.

• ApplicationRequiresElevation

  Parámetro opcional Boolean .

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

• ApplicationUrl

  Parámetro opcional String .

  Especifica la ubicación web que hospeda el instalador de la aplicación.

• BootstrapperComponentFiles

  Parámetro de salida opcional String[] .

  Especifica la ubicación compilada de los archivos de paquete previo.

• BootstrapperItems

  Parámetro opcional ITaskItem[] .

  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 Include atributo representa el nombre de un requisito previo que se debe instalar. Los ProductName metadatos del elemento son opcionales y los usará el motor de compilación como un 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 ninguno ApplicationFile . Debe incluir un elemento para cada requisito previo que se debe instalar para la aplicación.

  Si no se especifica ni el BootstrapperItems parámetro ni el ApplicationFile parámetro , se producirá un error de compilación.

• BootstrapperKeyFile

  Parámetro de salida opcional String .

  Especifica la ubicación compilada de setup.exe

• ComponentsLocation

  Parámetro opcional String .

  Especifica una ubicación para que el programa previo busque los requisitos previos de instalación que se van a instalar. Este parámetro puede tener los siguientes valores:

  • HomeSite: indica que el proveedor del componente hospeda el requisito previo.

  • Relative: indica que el requisito previo está en la misma ubicación de la aplicación.

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

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

• ComponentsUrl

  Parámetro opcional String .

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

• CopyComponents

  Parámetro opcional Boolean .

  Si truees , el programa previo copia todos los archivos de salida en la ruta de acceso especificada en el OutputPath parámetro . Los valores del BootstrapperComponentFiles parámetro deben basarse en esta ruta de acceso. Si falsees , los archivos no se copian y los BootstrapperComponentFiles valores se basan en el valor del Path parámetro . El valor predeterminado de este parámetro es true.

• Culture

  Parámetro opcional String .

  Especifica la referencia cultural que se va a usar 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 FallbackCulture parámetro .

• FallbackCulture

  Parámetro opcional String .

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

• OutputPath

  Parámetro opcional String .

  Especifica la ubicación para copiar setup.exe y todos los archivos de paquete.

• Path

  Parámetro opcional String .

  Especifica la ubicación de todos los paquetes de requisitos previos disponibles.

• SupportUrl

  Parámetro opcional String .

  Especifica la dirección URL que se va a proporcionar si se produce un error en la instalación del programa previo.

• Validate

  Parámetro opcional Boolean .

  Si truees , el programa previo realiza la validación XSD en los elementos del programa previo de entrada especificados. El valor predeterminado de este parámetro es false.

Observaciones

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

Example

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

<ItemGroup>
  <BootstrapperFile Include="Microsoft.Net.Framework.4.8">
    <ProductName>.NET Framework 4.8</ProductName>
  </BootstrapperFile>
</ItemGroup>

<Target Name="CustomBootstrapper">
  <GenerateBootstrapper
    ApplicationFile="MyApp.exe"
    BootstrapperItems="@(BootstrapperFile)"
    OutputPath="$(OutputPath)"
    ComponentsLocation="Relative" />
</Target>

Consulte también

• Tareas
• Referencia de tareas