GenerateBootstrapper, tâche

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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

Le tableau ci-dessous décrit les paramètres de la tâche GenerateBootstrapper.

  • 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 ni le BootstrapperItems ni le ApplicationFile est précisé.

  • ApplicationName

    Paramètre String facultatif.

    Spécifie le nom de l’application qui installe le programme d’amorçage. Ce nom apparaîtra dans l’interface Utilisateur du programme d’amorçage utilise pendant l’installation.

  • ApplicationRequiresElevation

    Paramètre Boolean facultatif.

    Si 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

    Facultatif String[] paramètre de sortie.

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

  • BootstrapperItems

    Facultatif ITaskItem[] paramètre.

    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>  
    
    

    Le Include attribut est utilisé pour représenter le nom d’un composant requis qui doit être installé. Le ProductName métadonnées de l’élément est facultative et sera utilisée 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 doivent pas MSBuild paramètres d’entrée, sauf si aucun ApplicationFile est 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 ni le BootstrapperItems ni le ApplicationFile est précisé.

  • BootstrapperKeyFile

    Facultatif String paramètre de sortie.

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

  • ComponentsLocation

    Paramètre String facultatif.

    Spécifie l’emplacement du programme d’amorçage 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 du composant.

    • Relative: Indique que le composant requis est au même emplacement de l’application.

    • Absolute: Indique que tous les composants doivent être liés à une URL centralisée. Cette valeur doit être utilisée conjointement avec la ComponentsUrl paramètre d’entrée.

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

  • ComponentsUrl

    Paramètre String facultatif.

    Spécifie l’URL contenant les composants requis.

  • CopyComponents

    Paramètre Boolean facultatif.

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

  • Culture

    Paramètre String facultatif.

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

  • FallbackCulture

    Paramètre String facultatif.

    Spécifie la culture secondaire à utiliser pour l’interface Utilisateur du programme d’amorçage et conditions préalables d’installation.

  • OutputPath

    Paramètre String facultatif.

    Spécifie l’emplacement où 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 true, le programme d’amorçage exécute 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.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la TaskExtension (classe), qui elle-même hérite de la tâches classe. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez TaskExtension Base Class.

L’exemple suivant utilise le GenerateBootstrapper tâche permettant d’installer une application qui doit avoir le .NET Framework 2.0 installé comme composant requis.

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

Tâches
Référence des tâches

Afficher: