GenerateBootstrapper, tâche
Offre un moyen automatisé de détecter, télécharger et installer une application ainsi que ses composants requis. Elle sert de programme d'installation unique qui intègre les programmes d'installation séparés de tous les composants d'une application.
Paramètres de la tâche
Le tableau suivant décrit les paramètres de la tâche GenerateBootstrapper.
Paramètre |
Description |
|---|---|
ApplicationFile |
Paramètre String facultatif. Spécifie le fichier que le programme d'amorçage utilise pour commencer l'installation de l'application une fois que tous les composants requis ont été installés. Une erreur de build se produit si vous ne spécifiez pas le paramètre BootstrapperItems ou le paramètre ApplicationFile. |
ApplicationName |
Paramètre String facultatif. Spécifie le nom de l'application que le programme d'amorçage utilisera. Ce nom apparaîtra dans l'interface utilisateur que le programme d'amorçage utilise pendant l'installation. |
ApplicationRequiresElevation |
Paramètre Boolean facultatif. Si la valeur est true, le composant s'exécute avec des autorisations élevées lorsqu'il est installé sur un ordinateur cible. |
ApplicationUrl |
Paramètre String facultatif. Spécifie l'emplacement Web qui héberge le programme d'installation de l'application. |
BootstrapperComponentFiles |
Paramètre de sortie String[] facultatif. Spécifie l'emplacement de génération des fichiers du package du programme d'amorçage. |
BootstrapperItems |
Paramètre ITaskItem[] optionnel. 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 : L'attribut Include est utilisé pour représenter le nom d'un composant requis qui doit être installé. Les métadonnées d'élément ProductName sont facultatives, et sont utilisées par le moteur de génération comme un nom convivial au cas où le package ne peut pas être trouvé. Ces éléments ne sont pas des paramètres d'entrée MSBuild obligatoires, à moins qu'aucun ApplicationFile ne soit spécifié. Vous devez inclure un élément pour chaque composant requis qui doit être installé pour votre application. Une erreur de build se produit si vous ne spécifiez pas le paramètre BootstrapperItems ou le paramètre ApplicationFile. |
BootstrapperKeyFile |
Paramètre de sortie String facultatif. Spécifie l'emplacement de génération de setup.exe. |
ComponentsLocation |
Paramètre String facultatif. Spécifie un emplacement dans lequel le programme d'amorçage doit rechercher les composants requis à installer. Ce paramètre peut avoir les valeurs suivantes :
Si ComponentsLocation n'est pas spécifié, HomeSite est utilisé par défaut. |
ComponentsUrl |
Paramètre String facultatif. Spécifie l'URL qui contient les conditions préalables d'installation. |
CopyComponents |
Paramètre Boolean facultatif. Si la valeur est true, le programme d'amorçage copie tous les fichiers de sortie vers le chemin d'accès spécifié dans le paramètre OutputPath. Les valeurs du paramètre BootstrapperComponentFiles doivent toutes être basées sur ce chemin d'accès. Si la valeur est false, les fichiers ne sont pas copiés, et les valeurs BootstrapperComponentFiles sont basées sur la valeur du paramètre Path. La valeur par défaut de ce paramètre est true. |
Culture |
Paramètre String facultatif. Spécifie la culture à utiliser pour les conditions préalables pour l'installation et l'interface utilisateur du programme d'amorçage. Si la culture spécifiée n'est pas disponible, la tâche utilise la valeur du paramètre FallbackCulture. |
FallbackCulture |
Paramètre String facultatif. Spécifie la culture secondaire à utiliser pour les conditions préalables pour l'installation et l'interface utilisateur du programme d'amorçage. |
OutputPath |
Paramètre String facultatif. Spécifie l'emplacement dans lequel copier setup.exe et tous les fichiers du package. |
Path |
Paramètre String facultatif. Spécifie l'emplacement de tous les packages requis disponibles. |
SupportUrl |
Paramètre String facultatif. Spécifie l'URL à fournir si l'installation du programme d'amorçage échoue. |
Validate |
Paramètre Boolean facultatif. Si la valeur est true, le programme d'amorçage exécute la validation XSD sur les éléments du programme d'amorçage d'entrée spécifiés. La valeur par défaut de ce paramètre est false. |
Notes
En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui hérite elle-même de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Classe TaskExtension Base.
Exemple
L'exemple suivant utilise la tâche GenerateBootstrapper pour installer une application sur laquelle .NET Framework 2,0 doit être installé.
<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>