Partager via


GenerateBootstrapper, tâche

Mise à jour : novembre 2007

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

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 génération 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.

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[] facultatif.

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 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 requis, à 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 génération se produira 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 :

  • HomeSite : Indique que le composant requis est hébergé par le fournisseur de composant.

  • Relative : Indique que le composant requis est situé dans le même emplacement de l'application.

  • Absolute : Indique que tous les composants doivent être liés à une URL centralisée. Cette valeur peut être utilisée en conjonction avec le paramètre ComponentsUrl.

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.

Exemple

L'exemple suivant utilise la tâche GenerateBootstrapper pour installer une application sur laquelle le composant requis .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>

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild