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é. À 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 :
|
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 :
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 :
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 :
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 GenerateManifestBase, 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