Générer la tâche GenerateBootstrapper

Fournit un moyen automatisé de détecter, télécharger et installer une application et ses prérequis. Il sert de programme d’installation unique qui intègre les programmes d’installation distincts pour tous les composants constituant une application.

Paramètres de tâche

Les éléments suivants décrivent les paramètres de la GenerateBootstrapper tâche.

• ApplicationFile

  Paramètre facultatif String .

  Spécifie le fichier que le programme d’amorçage utilisera pour commencer l’installation de l’application une fois que toutes les conditions préalables ont été installées. Une erreur de génération se produit si ni le BootstrapperItemsApplicationFile paramètre n’est spécifié.

• ApplicationName

  Paramètre facultatif String .

  Spécifie le nom de l’application que le programme d’amorçage installera. Ce nom apparaît dans l’interface utilisateur utilisée par le programme d’amorçage pendant l’installation.

• ApplicationRequiresElevation

  Paramètre facultatif Boolean .

  Si true, le composant s’exécute avec des autorisations élevées lorsqu’il est installé sur un ordinateur cible.

• ApplicationUrl

  Paramètre facultatif String .

  Spécifie l’emplacement Web qui héberge le programme d’installation de l’application.

• BootstrapperComponentFiles

  Paramètre de sortie facultatif String[] .

  Spécifie l’emplacement généré des fichiers de package de programme d’amorçage.

• BootstrapperItems

  Paramètre facultatif ITaskItem[] .

  Spécifie les produits à générer dans le programme d’amorçage. Les éléments passés à ce paramètre doivent avoir la syntaxe suivante :

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

  L’attribut Include représente le nom d’un prérequis qui doit être installé. Les ProductName métadonnées d’élément sont facultatives et seront utilisées par le moteur de build comme nom convivial si le package est introuvable. Ces éléments ne sont pas obligatoires pour les paramètres d’entrée MSBuild, sauf si aucune valeur n’est ApplicationFile spécifiée. Vous devez inclure un élément pour chaque prérequis qui doit être installé pour votre application.

  Une erreur de génération se produit si ni le BootstrapperItemsApplicationFile paramètre n’est spécifié.

• BootstrapperKeyFile

  Paramètre de sortie facultatif String .

  Spécifie l’emplacement généré de setup.exe

• ComponentsLocation

  Paramètre facultatif String .

  Spécifie un emplacement pour le programme d’amorçage pour rechercher les prérequis d’installation à installer. Ce paramètre peut avoir les valeurs suivantes :

  • HomeSite: indique que la configuration requise est hébergée par le fournisseur de composants.

  • Relative: indique que la configuration requise se trouve à l’emplacement de l’application.

  • Absolute: indique que tous les composants sont à trouver dans une URL centralisée. Cette valeur doit être utilisée conjointement avec le paramètre d’entrée ComponentsUrl .

    Si ComponentsLocation ce n’est pas spécifié, HomeSite est utilisé par défaut.

• ComponentsUrl

  Paramètre facultatif String .

  Spécifie l’URL contenant les conditions préalables à l’installation.

• CopyComponents

  Paramètre facultatif Boolean .

  Si true, le programme d’amorçage copie tous les fichiers de sortie dans le chemin spécifié dans le OutputPath paramètre. Les valeurs du BootstrapperComponentFiles paramètre doivent toutes être basées sur ce chemin. Si false, les fichiers ne sont pas copiés et les BootstrapperComponentFiles valeurs sont basées sur la valeur du Path paramètre. La valeur par défaut de ce paramètre est true.

• Culture

  Paramètre facultatif String .

  Spécifie la culture à utiliser pour l’interface utilisateur du programme d’amorçage et les prérequis d’installation. Si la culture spécifiée n’est pas disponible, la tâche utilise la valeur du FallbackCulture paramètre.

• FallbackCulture

  Paramètre facultatif String .

  Spécifie la culture secondaire à utiliser pour l’interface utilisateur du programme d’amorçage et les prérequis d’installation.

• OutputPath

  Paramètre facultatif String .

  Spécifie l’emplacement à copier setup.exe et tous les fichiers de package.

• Path

  Paramètre facultatif String .

  Spécifie l’emplacement de tous les packages requis disponibles.

• SupportUrl

  Paramètre facultatif String .

  Spécifie l’URL à fournir si l’installation du programme d’amorçage échoue.

• Validate

  Paramètre facultatif Boolean .

  Si true, le programme d’amorçage effectue la validation XSD sur les éléments de programme d’amorçage d’entrée spécifiés. La valeur par défaut de ce paramètre est false.

Remarques

Outre les paramètres répertoriés ci-dessus, cette tâche hérite des paramètres de la TaskExtension classe, qui lui-même hérite de la Task classe. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez la classe de base TaskExtension.

Example

L’exemple suivant utilise la GenerateBootstrapper tâche pour installer une application qui doit avoir installé .NET Framework 4.8 comme condition préalable.

<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>

Voir aussi

• Tâches
• Informations de référence sur les tâches