GenerateDeploymentManifest Task

 

Date de publication : juin 2016

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

Génère un manifeste de déploiement ClickOnce. Un manifeste de déploiement ClickOnce décrit le déploiement d'une application en définissant une identité unique pour le déploiement, en identifiant les caractéristiques du déploiement, par exemple le mode installation ou en ligne, en spécifiant des paramètres de mise à jour de l'application et des emplacements de mise à jour et en indiquant le manifeste d'application ClickOnce correspondant.

Le tableau suivant décrit les paramètres de la tâche GenerateDeploymentManifest.

ParamètreDescription
AssemblyNameParamètre String facultatif.

Spécifie le champ Name de l'identité de l'assembly pour le manifeste généré. Si ce paramètre n'est pas spécifié, le nom est déduit à partir des paramètres EntryPoint ou InputManifest. S'il n'est pas possible de déduire le nom, la tâche génère une erreur.
AssemblyVersionParamètre String facultatif.

Spécifie le champ Version de l'identité de l'assembly pour le manifeste généré. Si ce paramètre n'est pas spécifié, la tâche utilise la valeur "1.0.0.0".
CreateDesktopShortcutParamètre Boolean facultatif.

Si la valeur est true, une icône est créée sur le Bureau pendant l'installation de l'application ClickOnce.
DeploymentUrlParamètre String facultatif.

Spécifie l'emplacement de mise à jour de l'application. Si ce paramètre n'est pas précisé, aucun emplacement de mise à jour n'est défini pour l'application. Toutefois, si le paramètre UpdateEnabled a la valeur true, l'emplacement de mise à jour doit être spécifié. La valeur spécifiée doit être un chemin d'URL ou UNC complet.
DescriptionParamètre String facultatif.

Spécifie une description facultative de l'application.
DisallowUrlActivationParamètre Boolean facultatif.

Spécifie si l'application doit être exécutée automatiquement lorsqu'elle est ouverte via une URL. Si ce paramètre a la valeur true, l'application ne peut être démarrée qu'à partir du menu Démarrer. La valeur par défaut de ce paramètre est false. Cette entrée s'applique uniquement lorsque la valeur du paramètre Install est true.
EntryPointParamètre ITaskItem[] optionnel.

Indique le point d'entrée de l'assembly de manifeste généré. Pour un manifeste de déploiement ClickOnce, cette entrée spécifie le manifeste d'application ClickOnce.

Dans Visual Studio 2005, la GenerateApplicationManifest Task requiert un EntryPoint pour générer un manifeste d'application (les manifestes d'assembly ou natifs ne requièrent pas de EntryPoint). Cette spécification a été appliquée avec l'erreur de build : « MSB3185 : EntryPoint non spécifié pour le manifeste ».

 MSBuild ne publie pas cette erreur lorsque le paramètre de tâche EntryPoint n'est pas spécifié. À la place, la balise <customHostSpecified> est insérée en tant qu'enfant de la balise <entryPoint>, par exemple :

 <entryPoint xmlns="urn:schemas-

 microsoft-com:asm.v2">

 <co.v1:customHostSpecified />

 </entryPoint>

Vous pouvez ajouter des dépendances DLL au manifeste d'application en suivant ces étapes :

1. Résolvez les références de l'assembly avec un appel à ResolveAssemblyReference.
2. Passez la sortie de la tâche précédente et l'assembly lui-même à ResolveManifestFiles.
3. Passez les dépendances à GenerateApplicationManifest à l'aide du paramètre Dependencies.
ErrorReportUrlParamètre String facultatif.

Spécifie l'URL de la page Web affichée dans les boîtes de dialogue pendant les installations ClickOnce.
InputManifestParamètre ITaskItem facultatif.

Indique un document XML d'entrée qui sert de base au générateur de manifeste. Des données structurées, telles que des définitions de manifeste personnalisées, peuvent ainsi être reflétées dans le manifeste de sortie. L'élément racine du document XML doit être un nœud d'assembly dans l'espace de noms asmv1.
InstallParamètre Boolean facultatif.

Spécifie si l'application est une application installée ou une application en ligne uniquement. 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 Ajouter ou supprimer des programmes. S'il a la valeur false, l'application est conçue pour une utilisation en ligne à partir d'une page Web. La valeur par défaut de ce paramètre est true.
MapFileExtensionsParamètre Boolean facultatif.

Spécifie si le mappage d'extension de nom de fichier .deploy est utilisé. Si ce paramètre a la valeur true, chaque fichier programme est publié avec une extension de nom de fichier .deploy. Cette option est utile pour la sécurité du serveur Web, car elle limite le nombre d'extensions de noms de fichiers qui doivent être débloquées pour activer le déploiement d'application ClickOnce. La valeur par défaut de ce paramètre est false.
MaxTargetPathParamètre String facultatif.

Spécifie la longueur maximale autorisée d'un chemin d'accès dans un déploiement d'application ClickOnce. Si ce paramètre est spécifié, la longueur de chaque chemin d'accès dans l'application est comparée à cette limite. Tout élément qui dépasse la limite entraîne un avertissement de build. Si cette entrée n'est pas spécifiée ou est zéro, aucune vérification n'est effectuée.
MinimumRequiredVersionParamètre String facultatif.

Spécifie si l'utilisateur peut ignorer la mise à jour. Si l'utilisateur possède une version antérieure à la version minimale requise, il ne peut pas ignorer la mise à jour. Cette entrée est uniquement d'application lorsque la valeur du paramètre Install est true.
OutputManifestParamètre ITaskItem facultatif.

Spécifie le nom du fichier manifeste de sortie généré. Si ce paramètre n'est pas spécifié, le nom du fichier de sortie est déduit à partir de l'identité du manifeste généré.
PlatformParamètre String facultatif.

Spécifie la plateforme cible de l'application. Ce paramètre peut avoir les valeurs suivantes :

- AnyCPU
- x86
- x64
- Itanium

La valeur par défaut est AnyCPU.
ProductParamètre String facultatif.

Spécifie le nom de l'application. Si ce paramètre n'est pas spécifié, le nom est déduit à partir de l'identité du manifeste généré. Ce nom est utilisé comme nom de raccourci dans le menu Démarrer et fait partie du nom qui apparaît dans la boîte de dialogue Ajouter ou supprimer des programmes.
PublisherParamètre String facultatif.

Spécifie l'éditeur de l'application. Si ce paramètre n'est pas défini, le nom est déduit à partir de l'utilisateur enregistré ou de l'identité du manifeste généré. Ce nom est utilisé comme nom de dossier dans le menu Démarrer et fait partie du nom qui apparaît dans la boîte de dialogue Ajouter ou supprimer des programmes.
SuiteNamelParamètre String facultatif.

Spécifie le nom du dossier dans le menu Démarrer où l'application est située après le déploiement ClickOnce.
SupportUrlParamètre String facultatif.

Spécifie le lien qui apparaît dans la boîte de dialogue Ajouter ou supprimer des programmes pour l'application. La valeur spécifiée doit être un chemin d'URL ou UNC complet.
TargetCultureParamètre String facultatif.

Identifie la culture de l'application et spécifie le champ Language de l'identité de l'assembly pour le manifeste généré. Si ce paramètre n'est pas spécifié, il est supposé que l'application possède une culture dite indifférente.
TrustUrlParametersParamètre Boolean facultatif.

Spécifie si les paramètres de la chaîne de requête de l'URL doivent être accessibles à l'application. La valeur par défaut de ce paramètre est false, ce qui signifie que les paramètres ne sont pas accessibles à l'application.
UpdateEnabledParamètre Boolean facultatif.

Indique si les mises à jour sont activées pour l'application. La valeur par défaut de ce paramètre est false. Ce paramètre s'applique dans le seul cas où la valeur du paramètre Install est true.
UpdateIntervalParamètre Int32 facultatif.

Spécifie l'intervalle de mise à jour pour l'application. La valeur par défaut de ce paramètre est zéro. Ce paramètre n'est d'application que dans le cas où les paramètres Install et UpdateEnabled ont tous deux la valeur true.
UpdateModeParamètre String facultatif.

Spécifie 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. Ce paramètre peut avoir les valeurs suivantes :

- Foreground
- Background

La valeur par défaut de ce paramètre est Background. Ce paramètre n'est d'application que dans le cas où les paramètres Install et UpdateEnabled ont tous deux la valeur true.
UpdateUnitParamètre String facultatif.

Spécifie les unités du paramètre UpdateInterval. Ce paramètre peut avoir les valeurs suivantes :

- Hours
- Days
- Weeks

Ce paramètre n'est d'application que dans le cas où les paramètres Install et UpdateEnabled ont tous deux la valeur true.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe GenerateManifestBase, qui hérite elle-même de la classe Task. Pour obtenir la liste des paramètres de la classe Tâche, consultez Task Base Class.

Tasks
GenerateApplicationManifest Task
SignFile Task
Task Reference

Afficher: