GenerateBootstrapper (tâche)GenerateBootstrapper task

Fournit un moyen automatisé de détecter, télécharger et installer une application et ses composants requis.Provides an automated way to detect, download, and install an application and its prerequisites. Elle constitue un seul programme d’installation qui intègre les programmes d’installation distincts de tous les composants d’une application.It serves as a single installer that integrates the separate installers for all the components making up an application.

Paramètres de tâcheTask parameters

Le tableau ci-dessous décrit les paramètres de la tâche GenerateBootstrapper.The following describe the parameters of the GenerateBootstrapper task.

  • ApplicationFile

    Paramètre String facultatif.Optional String parameter.

    Spécifie le fichier utilisé par le programme d’amorçage pour commencer l’installation de l’application une fois tous les composants requis installés.Specifies the file the bootstrapper will use to begin the installation of the application after all prerequisites have been installed. Une erreur de build se produit si ni le paramètre BootstrapperItems ni le paramètre ApplicationFile ne sont spécifiés.A build error will result if neither the BootstrapperItems nor the ApplicationFile parameter is specified.

  • ApplicationName

    Paramètre String facultatif.Optional String parameter.

    Spécifie le nom de l’application installée par le programme d’amorçage.Specifies the name of the application that the bootstrapper will install. Ce nom est affiché dans l’interface utilisateur du programme d’amorçage pendant l’installation.This name will appear in the UI the bootstrapper uses during installation.

  • ApplicationRequiresElevation

    Paramètre Boolean facultatif.Optional Boolean parameter.

    Si true, le composant s’exécute avec des autorisations élevées lorsqu’il est installé sur un ordinateur cible.If true, the component runs with elevated permissions when it is installed on a target computer.

  • ApplicationUrl

    Paramètre String facultatif.Optional String parameter.

    Indique l’emplacement web qui héberge le programme d’installation de l’application.Specifies the Web location that is hosting the application's installer.

  • BootstrapperComponentFiles

    Paramètre de sortie String[] facultatif.Optional String[] output parameter.

    Spécifie l’emplacement généré des fichiers de package du programme d’amorçage.Specifies the built location of bootstrapper package files.

  • BootstrapperItems

    Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

    Indique les produits à générer dans le programme d’amorçage.Specifies the products to build into the bootstrapper. Les éléments transmis à ce paramètre doivent avoir la syntaxe suivante :The items passed to this parameter should have the following syntax:

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

    L’attribut Include représente le nom d’un composant requis qui doit être installé.The Include attribute represents the name of a prerequisite that should be installed. Les métadonnées de l’élément ProductName sont facultatives et sont utilisées par le moteur de génération comme nom convivial si le package est introuvable.The ProductName item metadata is optional, and will be used by the build engine as a user-friendly name if the package cannot be found. Ces éléments ne sont pas des paramètres d’entrée MSBuildMSBuild obligatoires à moins qu’aucun ApplicationFile ne soit spécifié.These items are not required MSBuildMSBuild input parameters, unless no ApplicationFile is specified. Vous devez inclure un élément pour chaque composant requis qui doit être installé pour votre application.You should include one item for every prerequisite that must be installed for your application.

    Une erreur de build se produit si ni le paramètre BootstrapperItems ni le paramètre ApplicationFile ne sont spécifiés.A build error will result if neither the BootstrapperItems nor the ApplicationFile parameter is specified.

  • BootstrapperKeyFile

    Paramètre de sortie String facultatif.Optional String output parameter.

    Spécifie l’emplacement de génération de setup.exe.Specifies the built location of setup.exe

  • ComponentsLocation

    Paramètre String facultatif.Optional String parameter.

    Indique un emplacement où le programme d’amorçage doit rechercher les composants requis à installer.Specifies a location for the bootstrapper to look for installation prerequisites to install. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

    • HomeSite : indique que le composant requis est hébergé par le fournisseur du composant.HomeSite: Indicates that the prerequisite is being hosted by the component vendor.

    • Relative : indique que le composant requis est au même emplacement de l’application.Relative: Indicates that the prerequisite is at the same location of the application.

    • Absolute : indique que tous les composants doivent se trouver dans une URL centralisée.Absolute: Indicates that all components are to be found at a centralized URL. Cette valeur doit être utilisée conjointement avec le paramètre d’entrée ComponentsUrl.This value should be used in conjunction with the ComponentsUrl input parameter.

      Si ComponentsLocation n’est pas spécifié, HomeSite est utilisé par défaut.If ComponentsLocation is not specified, HomeSite is used by default.

  • ComponentsUrl

    Paramètre String facultatif.Optional String parameter.

    Spécifie l’URL qui contient les conditions préalables à l’installation.Specifies the URL containing the installation prerequisites.

  • CopyComponents

    Paramètre Boolean facultatif.Optional Boolean parameter.

    Si true, le programme d’amorçage copie tous les fichiers de sortie dans le chemin d’accès spécifié dans le paramètre OutputPath.If true, the bootstrapper copies all output files to the path specified in the OutputPath parameter. Les valeurs du paramètre BootstrapperComponentFiles doivent toutes être basées sur ce chemin d’accès.The values of the BootstrapperComponentFiles parameter should all be based on this path. Si false, les fichiers ne sont pas copiés, et les valeurs BootstrapperComponentFiles sont basées sur la valeur du paramètre Path.If false, the files are not copied, and the BootstrapperComponentFiles values are based on the value of the Path parameter. La valeur par défaut de ce paramètre est true.The default value of this parameter is true.

  • Culture

    Paramètre String facultatif.Optional String parameter.

    Spécifie la culture à utiliser pour l’interface utilisateur du programme d’amorçage et la configuration requise pour l’installation.Specifies the culture to use for the bootstrapper UI and installation prerequisites. Si la culture spécifiée n’est pas disponible, la tâche utilise la valeur du paramètre FallbackCulture.If the specified culture is unavailable, the task uses the value of the FallbackCulture parameter.

  • FallbackCulture

    Paramètre String facultatif.Optional String parameter.

    Spécifie la culture secondaire à utiliser pour l’interface utilisateur du programme d’amorçage et la configuration requise pour l’installation.Specifies the secondary culture to use for the bootstrapper UI and installation prerequisites.

  • OutputPath

    Paramètre String facultatif.Optional String parameter.

    Indique l’emplacement où copier setup.exe et tous les fichiers du package.Specifies the location to copy setup.exe and all package files.

  • Path

    Paramètre String facultatif.Optional String parameter.

    Indique l’emplacement de tous les packages requis disponibles.Specifies the location of all available prerequisite packages.

  • SupportUrl

    Paramètre String facultatif.Optional String parameter.

    Spécifie l’URL à fournir en cas d’échec de l’installation du programme d’amorçage.Specifies the URL to provide if the bootstrapper installation fails.

  • Validate

    Paramètre Boolean facultatif.Optional Boolean parameter.

    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.If true, the bootstrapper performs XSD validation on the specified input bootstrapper items. La valeur par défaut de ce paramètre est false.The default value of this parameter is false.

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension , qui elle-même hérite de la classe Task .In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.For a list of these additional parameters and their descriptions, see TaskExtension base class.

ExempleExample

L’exemple suivant utilise la tâche GenerateBootstrapper pour installer une application qui doit avoir le composant .NET Framework 2.0 installé au titre de prérequis.The following example uses the GenerateBootstrapper task to install an application that must have the .NET Framework 2.0 installed as a prerequisite.

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

Voir aussiSee also