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 : il définit une identité unique pour le déploiement, identifie des caractéristiques de déploiement comme le mode d’installation ou le mode en ligne, spécifie les paramètres de mise à jour de l’application et les emplacements de mise à jour, et indique le manifeste de l’application ClickOnce correspondant.
Paramètres
Le tableau ci-dessous 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é d’assembly pour le manifeste généré. Si vous ne spécifiez pas ce paramètre, le nom est déduit du paramètre EntryPoint ou InputManifest. Si le nom ne peut pas être déduit, la tâche génère une erreur. |
AssemblyVersion |
Paramètre String facultatif.Spécifie le champ Version de l’identité d’assembly pour le manifeste généré. Si vous ne spécifiez pas ce paramètre, 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 d’application ClickOnce. |
DeploymentUrl |
Paramètre String facultatif.Spécifie l’emplacement de mise à jour de l’application. Si vous ne spécifiez pas ce paramètre, aucun emplacement de mise à jour n’est défini pour l’application. Toutefois, si le paramètre UpdateEnabled est true, vous devez spécifier l’emplacement de mise à jour. La valeur spécifiée doit être un chemin URL ou UNC complet. |
Description |
Paramètre String facultatif.Spécifie une description facultative pour l’application. |
DisallowUrlActivation |
Paramètre Boolean facultatif.Indique si l’application doit être exécutée automatiquement quand elle est ouverte par le biais d’une URL. Si ce paramètre est true, l’application ne peut être lancée que par le menu Démarrer. La valeur par défaut de ce paramètre est false. Cette entrée s’applique uniquement quand le paramètre Install a la valeur true. |
EntryPoint |
Paramètre ITaskItem[] facultatif.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 de l’application ClickOnce. 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 :<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 : 1. Résolvez les références d’assembly par 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 System.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 à utiliser comme base pour le générateur de manifeste. Ainsi, les données structurées telles que les définitions de manifeste personnalisées sont reflétées dans le manifeste de sortie. L’élément racine dans le document XML doit être un nœud d’assembly dans l’espace de noms asmv1. |
Install |
Paramètre Boolean facultatif.Indique 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 Ajout/Suppression de programmes. Si ce paramètre 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.Indique 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é 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 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 de fichier dans un déploiement d’application ClickOnce. Si vous spécifiez ce paramètre, la longueur de chaque chemin de fichier dans l’application est comparée à cette limite. Tout élément qui dépasse la limite provoque l’affichage d’un avertissement de génération. Si cette entrée n’est pas spécifiée ou est égale à zéro, aucune vérification n’est effectuée. |
MinimumRequiredVersion |
Paramètre String facultatif.Indique si l’utilisateur peut ignorer la mise à jour. Si l’utilisateur a une version antérieure à la version minimale requise, il ne pourra pas ignorer la mise à jour. Cette entrée s’applique uniquement quand le paramètre Install a la valeur true. |
OutputManifest |
Paramètre ITaskItem facultatif. Spécifie le nom du fichier manifeste de sortie généré. 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é. |
Platform |
Paramètre String facultatif.Spécifie la plateforme cible de l’application. Ce paramètre peut avoir les valeurs suivantes : - AnyCPU- x86- x64- ItaniumLa valeur par défaut est AnyCPU. |
Product |
Paramètre String facultatif.Spécifie le nom de l'application. Si vous ne spécifiez pas ce paramètre, le nom est déduit de l’identité du manifeste généré. 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. |
Publisher |
Paramètre String facultatif.Spécifie l’éditeur de l’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é. 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. |
SuiteNamel |
Paramètre String facultatif.Spécifie le nom du dossier dans le menu Démarrer où figure l’application après le déploiement ClickOnce. |
SupportUrl |
Paramètre String facultatif.Spécifie le lien qui apparaît dans la boîte de dialogue Ajout/Suppression de programmes pour l’application. La valeur spécifiée doit être un chemin URL ou UNC complet. |
TargetCulture |
Paramètre String facultatif.Identifie la culture de l’application et spécifie le champ Language de l’identité d’assembly pour le manifeste généré. Si vous ne spécifiez pas ce paramètre, il est supposé que l’application est indifférente quant à la culture. |
TrustUrlParameters |
Paramètre Boolean facultatif.Indique si les paramètres de chaîne de requête 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 seront pas accessibles à l’application. |
UpdateEnabled |
Paramètre Boolean facultatif.Indique si l’application est activée pour les mises à jour. La valeur par défaut de ce paramètre est false. Ce paramètre s’applique uniquement quand le paramètre Install a la valeur true. |
UpdateInterval |
Paramètre Int32 facultatif.Spécifie l’intervalle de mise à jour de l’application. La valeur par défaut de ce paramètre est zéro. Ce paramètre s’applique uniquement quand les paramètres Install et UpdateEnabled ont tous deux la valeur true. |
UpdateMode |
Paramètre String facultatif.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. Ce paramètre peut avoir les valeurs suivantes : - Foreground- BackgroundLa valeur par défaut de ce paramètre est Background. Ce paramètre s’applique uniquement quand les paramètres Install et UpdateEnabled ont tous deux la valeur true. |
UpdateUnit |
Paramètre String facultatif.Spécifie les unités pour le paramètre UpdateInterval. Ce paramètre peut avoir les valeurs suivantes :- Hours- Days- WeeksCe paramètre s’applique uniquement quand les paramètres Install et UpdateEnabled ont tous deux la valeur true. |
Remarques
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 . Pour obtenir la liste des paramètres de la classe Task, consultez Classe de base de tâche.