Partager via


GenerateDeploymentManifest, tâche

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.

Paramètres

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

Paramètre

Description

AssemblyName

Paramè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.

AssemblyVersion

Paramè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".

CreateDesktopShortcut

Paramètre Boolean facultatif.

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

DeploymentUrl

Paramè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.

Description

Paramètre String facultatif.

Spécifie une description facultative de l'application.

DisallowUrlActivation

Paramè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.

EntryPoint

Paramè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, tâche 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é.Toutefois, 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.

ErrorReportUrl

Paramètre [String] facultatif.

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

InputManifest

Paramè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.

Install

Paramè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.

MapFileExtensions

Paramè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.

MaxTargetPath

Paramè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.

MinimumRequiredVersion

Paramè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.

OutputManifest

Paramè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é.

Platform

Paramè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.

Product

Paramè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.

Publisher

Paramè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.

SuiteNamel

Paramè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.

SupportUrl

Paramè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.

TargetCulture

Paramè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.

TrustUrlParameters

Paramè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.

UpdateEnabled

Paramè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.

UpdateInterval

Paramè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.

UpdateMode

Paramè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.

UpdateUnit

Paramè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.

Notes

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

Voir aussi

Référence

GenerateApplicationManifest, tâche

SignFile, tâche

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild