GenerateDeploymentManifest (tâche)

  • Article

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
- Itanium

La 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
- Background

La 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
- Weeks

Ce 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.

Voir aussi