GenerateDeploymentManifest (tâche)GenerateDeploymentManifest task

Génère un manifeste de déploiement ClickOnceClickOnce.Generates a ClickOnceClickOnce deployment manifest. Un manifeste de déploiement ClickOnceClickOnce décrit le déploiement d’une application en définissant une identité unique pour le déploiement, en identifiant des caractéristiques de déploiement comme le mode d’installation ou le mode en ligne, en spécifiant les paramètres de mise à jour de l’application et les emplacements de mise à jour, et en indiquant le manifeste d’application ClickOnceClickOnce correspondant.A ClickOnceClickOnce deployment manifest describes the deployment of an application by defining a unique identity for the deployment, identifying deployment traits such as install or online mode, specifying application update settings and update locations, and indicating the corresponding ClickOnceClickOnce application manifest.

ParametersParameters

Le tableau ci-dessous décrit les paramètres de la tâche GenerateDeploymentManifest.The following table describes the parameters for the GenerateDeploymentManifest task.

ParamètreParameter DescriptionDescription
AssemblyName Paramètre String facultatif.Optional String parameter.

Spécifie le champ Name de l’identité d’assembly pour le manifeste généré.Specifies the Name field of the assembly identity for the generated manifest. Si vous ne spécifiez pas ce paramètre, le nom est déduit du paramètre EntryPoint ou InputManifest.If this parameter is not specified, the name is inferred from the EntryPoint or InputManifest parameters. Si le nom ne peut pas être déduit, la tâche génère une erreur.If the name cannot be inferred, the task throws an error.
AssemblyVersion Paramètre String facultatif.Optional String parameter.

Spécifie le champ Version de l’identité d’assembly pour le manifeste généré.Specifies the Version field of the assembly identity for the generated manifest. Si vous ne spécifiez pas ce paramètre, la tâche utilise la valeur « 1.0.0.0 ».If this parameter is not specified, the task uses the value "1.0.0.0".
CreateDesktopShortcut Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, une icône est créée sur le Bureau pendant l’installation d’application ClickOnce.If true, an icon is created on the desktop during ClickOnce application installation.
DeploymentUrl Paramètre String facultatif.Optional String parameter.

Spécifie l’emplacement de mise à jour de l’application.Specifies the update location for the application. Si vous ne spécifiez pas ce paramètre, aucun emplacement de mise à jour n’est défini pour l’application.If this parameter is not specified, no update location is defined for the application. Toutefois, si le paramètre UpdateEnabled est true, vous devez spécifier l’emplacement de mise à jour.However, if the UpdateEnabled parameter is true, the update location must be specified. La valeur spécifiée doit être un chemin URL ou UNC complet.The specified value should be a fully qualified URL or UNC path.
Description Paramètre String facultatif.Optional String parameter.

Spécifie une description facultative pour l’application.Specifies an optional description for the application.
DisallowUrlActivation Paramètre Boolean facultatif.Optional Boolean parameter.

Indique si l’application doit être exécutée automatiquement quand elle est ouverte par le biais d’une URL.Specifies whether the application should be run automatically when it is opened through a URL. Si ce paramètre est true, l’application ne peut être lancée que par le menu Démarrer.If this parameter is true, the application can only be started from the Start menu. La valeur par défaut de ce paramètre est false.The default value of this parameter is false. Cette entrée s’applique uniquement quand le paramètre Install a la valeur true.This input applies only when the Install parameter value is true.
EntryPoint Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Indique le point d’entrée de l’assembly de manifeste généré.Indicates the entry point for the generated manifest assembly. Pour un manifeste de déploiement ClickOnceClickOnce, cette entrée spécifie le manifeste d’application ClickOnceClickOnce.For a ClickOnceClickOnce deployment manifest, this input specifies the ClickOnceClickOnce application manifest.

Si le paramètre de tâche EntryPoint n’est pas spécifié, la balise <customHostSpecified> est insérée en tant qu’enfant de la balise <entryPoint>, par exemple :If the EntryPoint task parameter is not specified, the <customHostSpecified> tag is inserted as a child of the <entryPoint> tag, for example:

<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

Vous pouvez ajouter des dépendances de DLL au manifeste d’application en effectuant les étapes suivantes :You can add DLL dependencies to the application manifest by using the following steps:

1. résolvez les références d’assembly avec un appel à ResolveAssemblyReference.1. Resolve the assembly references with a call to ResolveAssemblyReference.
2. passer la sortie de la tâche précédente et l’assembly lui-même pour ResolveManifestFiles.2. Pass the output of the previous task and the assembly itself to ResolveManifestFiles.
3. passer les dépendances à l’aide du paramètre Dependencies pour GenerateApplicationManifest.3. Pass the dependencies by using the Dependencies parameter to GenerateApplicationManifest.
ErrorReportUrl Paramètre System.String facultatif.Optional System.String parameter.

Spécifie l’URL de la page web affichée dans les boîtes de dialogue pendant les installations ClickOnce.Specifies the URL of the web page that is displayed in dialog boxes during ClickOnce installations.
InputManifest Paramètre ITaskItem facultatif.Optional ITaskItem parameter.

Indique un document XML d’entrée à utiliser comme base pour le générateur de manifeste.Indicates an input XML document to serve as a base for the manifest generator. Ainsi, les données structurées telles que les définitions de manifeste personnalisées sont reflétées dans le manifeste de sortie.This enables structured data, such as custom manifest definitions, to be reflected in the output manifest. L’élément racine dans le document XML doit être un nœud d’assembly dans l’espace de noms asmv1.The root element in the XML document must be an assembly node in the asmv1 namespace.
Install Paramètre Boolean facultatif.Optional Boolean parameter.

Indique si l’application est une application installée ou une application en ligne uniquement.Specifies whether the application is an installed application or an online-only application. Si ce paramètre a la valeur true, l’application est installée dans le menu Démarrer de l’utilisateur et peut être supprimée à l’aide de la boîte de dialogue Ajout/Suppression de programmes.If this parameter is true, the application will be installed on the user's Start menu, and can be removed by using the Add or Remove Programs dialog box. Si ce paramètre a la valeur false, l’application est conçue pour une utilisation en ligne à partir d’une page web.If this parameter is false, the application is intended for online use from a web page. La valeur par défaut de ce paramètre est true.The default value of this parameter is true.
MapFileExtensions Paramètre Boolean facultatif.Optional Boolean parameter.

Indique si le mappage d’extension de nom de fichier .deploy est utilisé.Specifies whether the .deploy file name extension mapping is used. Si ce paramètre a la valeur true, chaque fichier programme est publié avec une extension de nom de fichier .deploy.If this parameter is true, every program file is published with a .deploy file name extension. Cette option est utile pour la sécurité de serveur web, afin de limiter le nombre d’extensions de nom de fichier qui doivent être débloquées pour activer le déploiement d’application ClickOnceClickOnce.This option is useful for web server security to limit the number of file name extensions that must be unblocked to enable ClickOnceClickOnce application deployment. La valeur par défaut de ce paramètre est false.The default value of this parameter is false.
MaxTargetPath Paramètre String facultatif.Optional String parameter.

Spécifie la longueur maximale autorisée d’un chemin de fichier dans un déploiement d’application ClickOnceClickOnce.Specifies the maximum allowed length of a file path in a ClickOnceClickOnce application deployment. Si vous spécifiez ce paramètre, la longueur de chaque chemin de fichier dans l’application est comparée à cette limite.If this parameter is specified, the length of each file path in the application is checked against this limit. Tout élément qui dépasse la limite provoque l’affichage d’un avertissement de génération.Any items that exceed the limit will cause a build warning. Si cette entrée n’est pas spécifiée ou est égale à zéro, aucune vérification n’est effectuée.If this input is not specified or is zero, no checking is performed.
MinimumRequiredVersion Paramètre String facultatif.Optional String parameter.

Indique si l’utilisateur peut ignorer la mise à jour.Specifies whether the user can skip the update. Si l’utilisateur a une version antérieure à la version minimale requise, il ne pourra pas ignorer la mise à jour.If the user has a version that is less than the minimum required, he will not have the option to skip the update. Cette entrée s’applique uniquement quand le paramètre Install a la valeur true.This input only applies when the value of the Install parameter is true.
OutputManifest Paramètre ITaskItem facultatif.Optional ITaskItem parameter.

Spécifie le nom du fichier manifeste de sortie généré.Specifies the name of the generated output manifest file. Si vous ne spécifiez pas ce paramètre, le nom du fichier de sortie est déduit de l’identité du manifeste généré.If this parameter is not specified, the name of the output file is inferred from the identity of the generated manifest.
Platform Paramètre String facultatif.Optional String parameter.

Spécifie la plateforme cible de l’application.Specifies the target platform of the application. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- AnyCPU
- x86
- x64
- Itanium

La valeur par défaut est AnyCPU.The default value is AnyCPU.
Product Paramètre String facultatif.Optional String parameter.

Spécifie le nom de l’application.Specifies the name of the application. Si vous ne spécifiez pas ce paramètre, le nom est déduit de l’identité du manifeste généré.If this parameter is not specified, the name is inferred from the identity of the generated manifest. Ce nom est utilisé comme nom du raccourci dans le menu Démarrer. Il fait partie du nom qui apparaît dans la boîte de dialogue Ajout/Suppression de programmes.This name is used for the shortcut name on the Start menu and is part of the name that appears in the Add or Remove Programs dialog box.
Publisher Paramètre String facultatif.Optional String parameter.

Spécifie l’éditeur de l’application.Specifies the publisher of the application. Si vous ne spécifiez pas ce paramètre, le nom est déduit de l’utilisateur enregistré ou de l’identité du manifeste généré.If this parameter is not specified, the name is inferred from the registered user, or the identity of the generated manifest. Ce nom est utilisé comme nom du dossier dans le menu Démarrer. Il fait partie du nom qui apparaît dans la boîte de dialogue Ajout/Suppression de programmes.This name is used for the folder name on the Start menu and is part of the name that appears in the Add or Remove Programs dialog box.
SuiteNamel Paramètre String facultatif.Optional String parameter.

Spécifie le nom du dossier dans le menu Démarrer où figure l’application après le déploiement ClickOnce.Specifies the name of the folder on the Start menu where the application is located after ClickOnce deployment.
SupportUrl Paramètre String facultatif.Optional String parameter.

Spécifie le lien qui apparaît dans la boîte de dialogue Ajout/Suppression de programmes pour l’application.Specifies the link that appears in the Add or Remove Programs dialog box for the application. La valeur spécifiée doit être un chemin URL ou UNC complet.The specified value should be a fully qualified URL or UNC path.
TargetCulture Paramètre String facultatif.Optional String parameter.

Identifie la culture de l’application et spécifie le champ Language de l’identité d’assembly pour le manifeste généré.Identifies the culture of the application, and specifies the Language field of the assembly identity for the generated manifest. Si vous ne spécifiez pas ce paramètre, il est supposé que l’application est indifférente quant à la culture.If this parameter is not specified, it is assumed that the application is culture invariant.
TrustUrlParameters Paramètre Boolean facultatif.Optional Boolean parameter.

Indique si les paramètres de chaîne de requête URL doivent être accessibles à l’application.Specifies whether URL query-string parameters should be made available to the application. La valeur par défaut de ce paramètre est false, ce qui signifie que les paramètres ne seront pas accessibles à l’application.The default value of this parameter is false, which indicates that parameters will not be available to the application.
UpdateEnabled Paramètre Boolean facultatif.Optional Boolean parameter.

Indique si l’application est activée pour les mises à jour.Indicates whether the application is enabled for updates. La valeur par défaut de ce paramètre est false.The default value of this parameter is false. Ce paramètre s’applique uniquement quand le paramètre Install a la valeur true.This parameter only applies when the value of the Install parameter is true.
UpdateInterval Paramètre Int32 facultatif.Optional Int32 parameter.

Spécifie l’intervalle de mise à jour de l’application.Specifies the update interval for the application. La valeur par défaut de ce paramètre est zéro.The default value of this parameter is zero. Ce paramètre s’applique uniquement quand les paramètres Install et UpdateEnabled ont tous deux la valeur true.This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.
UpdateMode Paramètre String facultatif.Optional String parameter.

Indique si les mises à jour doivent être vérifiées au premier plan avant de démarrer l’application, ou en arrière-plan pendant l’exécution de l’application.Specifies whether updates should be checked in the foreground before the application is started, or in the background as the application is running. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- Foreground
- Background

La valeur par défaut de ce paramètre est Background.The default value of this parameter is Background. Ce paramètre s’applique uniquement quand les paramètres Install et UpdateEnabled ont tous deux la valeur true.This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.
UpdateUnit Paramètre String facultatif.Optional String parameter.

Spécifie les unités pour le paramètre UpdateInterval.Specifies the units for the UpdateInterval parameter. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- Hours
- Days
- Weeks

Ce paramètre s’applique uniquement quand les paramètres Install et UpdateEnabled ont tous deux la valeur true.This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.

NotesRemarks

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

Voir aussiSee also