Informations de référence sur la ligne de commande MSBuild 04/11/2016 • 6 minut

Informations de référence sur la ligne de commande MSBuild 04/11/2016 • 6 minutes de lecture • Dans cet article Syntaxe Arguments Commutateurs Exemple 1 Exemple 2 Voir aussi Quand vous utilisez MSBuild.exe pour générer un fichier projet ou solution, vous pouvez inclure plusieurs commutateurs pour définir différents aspects du processus. Chaque commutateur est disponible sous deux formes : -commutateur et /commutateur. La documentation ne présente que la forme -commutateur. Les commutateurs ne respectent pas la casse. Si vous exécutez MSBuild à partir d’un interpréteur de commandes autre que l’invite de commandes Windows, les listes d’arguments d’un commutateur (séparées par des points-virgules ou des virgules) peuvent nécessiter des guillemets simples ou doubles pour s’assurer que les listes sont passées à MSBuild au lieu d’être interprétées par le shell. cmd Argument Description Syntaxe =Copier MSBuild.exe [Switches] [ProjectFile] Arguments Argument Description ProjectFile Génère les cibles dans le fichier projet que vous spécifiez. Si vous ne spécifiez pas de fichier projet, MSBuild recherche dans le répertoire de travail actif une extension de nom de fichier se terminant par proj et utilise ce fichier. Vous pouvez aussi spécifier un fichier solution Visual Studio pour cet argument. Commutateur Forme abrégée Description -detailedSummary -ds Affiche des informations détaillées à la fin journal de génération sur les configuration qui ont été générées et sur la façon dont e ont été planifiées sur les nœuds. -graphBuild [ : True ou False ] -Graph [ : True or False ] Provoque la construction et la génération graphique de projet par MSBuild. La construction d’un graphique implique l’identification des références de projet au dépendances de formulaire. La génération ce graphique implique de tenter de génér des références de projet avant les projets les référencent, ce qui diffère de la planification classique de MSBuild. Nécess MSBuild 16 ou une version ultérieure. -help /? ou -h Affichez des informations sur l’utilisation. commande suivante est un exemple : msbuild.exe -? -ignoreProjectExtensions: extensions -ignore: extensions Ignore les extensions spécifiées au momen déterminer quel fichier projet générer. Uti un point-virgule ou une virgule pour sépa les différentes extensions, comme dans l'exemple suivant : Commutateurs Commutateur Forme abrégée Description -ignoreprojectextensions:.vcproj,.sl -Interactive [ : True or False ] - Indique que les actions dans la génération sont autorisées à interagir avec l’utilisateu N’utilisez pas cet argument dans un scéna automatisé dans lequel l’interactivité n’est attendue. La spécification de-Interactive e identique à la spécification de-interactive true. Utilisez le paramètre pour remplacer valeur provenant d’un fichier réponse. -isolateProjects [ : True ou False ] -isoler [ : True ou False ] Permet à MSBuild de générer chaque proj manière isolée. Il s’agit d’un mode plus restrictif de MSBuild, car il requiert que le graphique du projet soit détectable statiquement au moment de l’évaluation, peut améliorer la planification et réduire la surcharge de mémoire lors de la génératio d’un grand ensemble de projets. -maxCpuCount [ : number ] -m[: number] Spécifie le nombre maximal de processus simultanés à utiliser au moment de la génération. Si vous n'incluez pas ce commutateur, la valeur par défaut est 1. S vous incluez ce commutateur sans spécifie valeur, MSBuild utilise le nombre de processeurs dont est équipé l'ordinateur. plus d’informations, consultez Génération parallèle de plusieurs projets. Dans l'exemple suivant, MSBuild a pour instruction de générer en utilisant trois processus MSBuild, ce qui permet de géné simultanément trois projets : msbuild myproject.proj -maxcpucount -noAutoResponse -noautorsp N’inclut automatiquement aucun fichier MSBuild.rsp. -nodeReuse: value -nr: value Active ou désactive la réutilisation de nœu MSBuild. Vous pouvez spécifier les valeurs i t Commutateur Forme abrégée Description suivantes : - True. Les nœuds sont conservés à l'issue la génération pour permettre aux générat suivantes de les utiliser (par défaut). - False. Les nœuds ne sont pas conservés l'issue de la génération. Un nœud correspond à un projet en cours d’exécution. Si le commutateur -maxcpuc est utilisé, plusieurs nœuds peuvent s’exéc simultanément. -nologo N'affiche pas la bannière de démarrage ni message de copyright. -PreProcess [ : filepath ] -pp[: filepath] Crée un fichier projet agrégé unique en incorporant tous les fichiers qui seraient importés lors d'une génération, avec une indication de leurs limites. Vous pouvez ut ce commutateur pour identifier plus facile les fichiers importés, leur emplacement d'origine, ainsi que les fichiers qui contribu à la génération. Quand ce commutateur e utilisé, le projet n’est pas généré. Si vous spécifiez un filepath, le fichier p agrégé est généré dans le fichier. Sinon, la sortie s'affiche dans la fenêtre de console. Pour plus d’informations sur l’utilisation de Import élément pour insérer un fichier pr dans un autre fichier projet, consultez imp élément (MSBuild) et Comment : utiliser la même cible dans plusieurs fichiers projet. - outputResultsCache[:cacheFile] -ORC [ : cacheFile] Fichier de cache de sortie dans lequel MSB écrit le contenu de ses caches de résultats build à la fin de la Build. La définition de c option active également les builds isolées isoler). Commutateur Forme abrégée Description -profileEvaluation: <file> - Profile l’évaluation MSBuild et écrit le résu dans le fichier spécifié. Si l’extension du fic spécifié est « . MD », le résultat est généré format de la démarque. Dans le cas contra un fichier séparé par des tabulations est généré. -property: name= value - p: name= value Définit ou substitue les propriétés de nive projet spécifiées, name correspondant au de la propriété et value à la valeur de la propriété. Spécifiez chaque propriété séparément ou utilisez un point-virgule ou virgule pour séparer plusieurs propriétés, comme dans l'exemple suivant : - property:WarningLevel=2;OutDir=bin\D -restore -r Exécute la cible Restore avant de génére cibles réelles. -restoreProperty: name=value PR name=value Définissez ou substituez ces propriétés au niveau du projet uniquement lors de la restauration et n’utilisez pas les propriétés spécifiées avec l’argument-Property. name le nom de la propriété, et value est la val de la propriété. Utilisez un point-virgule o une virgule pour séparer plusieurs proprié ou spécifiez chaque propriété séparément -target: targets -t: targets Génère les cibles spécifiées dans le projet. Spécifiez chaque cible séparément ou utili un point-virgule ou une virgule pour sépa plusieurs cibles, comme dans l'exemple suivant : Commutateur Forme abrégée Description -target:PrepareResources;Compile Si vous spécifiez des cibles à l'aide de ce commutateur, elles sont exécutées à la pla des cibles définies dans l'attribut DefaultTargets du fichier projet. Pour pl d’informations, consultez Ordre de généra des cibles et Guide pratique pour spécifier cible à générer en premier. Une cible est un groupe de tâches. Pour p d’informations, consultez l’article Targets (Cibles MSBuild). -cibles [ : file ] -TS [ : file ] Écrit la liste des cibles disponibles dans le fichier spécifié (ou le périphérique de sort aucun fichier n’est spécifié), sans exécuter processus de génération. attribut version -tv: version Spécifie la version de l'ensemble d'outils à utiliser pour générer le projet, comme dan l'exemple suivant : -toolsversion:3.5 À l’aide de ce commutateur, vous pouvez générer un projet et spécifier une version Commutateur Forme abrégée Description générer un projet et spécifier une version différente de celle spécifiée dans l’élémen Project (MSBuild). Pour plus d’information consultez Substitution des paramètres ToolsVersion. Pour MSBuild 4.5, vous pouvez attribuer à version les valeurs suivantes : 2.0, 3.5 et 4 Si vous spécifiez 4.0, la propriété de build VisualStudioVersion désigne le sous- ensemble d'outils à utiliser. Pour plus d’informations, consultez la section Sous- ensembles d’outils de Ensemble d’outils MSBuild (ToolsVersion). Un ensemble d’outils se compose des tâch des cibles et des outils utilisés pour génér une application. Les outils incluent des compilateurs tels que csc.exe et vbc.exe. Po plus d’informations sur les ensembles d’ou consultez Ensemble d’outils (ToolsVersion) Configurations standard et personnalisée l’ensemble d’outils et Multiciblage. Remar La version de l’ensemble d’outils n’est pas même que la version cible de .NET Framew qui est la version du .NET Framework sur lequel un projet est généré pour s’exécute Pour plus d’informations, consultez Versio cible de .NET Framework et plateforme cib -validate:[ schema] -val[ schema] Valide le fichier projet et, si la validation réussit, génère le projet. Si vous ne spécifiez pas schema, le projet validé par rapport au schéma par défaut. Commutateur Forme abrégée Description Si vous spécifiez schema, le projet est valid par rapport au schéma que vous spécifiez Voici un exemple de paramétrage : - validate:MyExtendedBuildSchema.xsd -verbosity: level -v: level Spécifie la quantité d'informations à affich dans le journal de génération. Chaque enregistreur d'événements affiche les événements en fonction du niveau de commentaires que vous définissez pour l'enregistreur d'événements en question. Vous pouvez spécifier les niveaux de détai suivants : q[uiet] , m[inimal] , n[ormal (valeur par défaut), d[etailed] et diag[nostic] . Voici un exemple de paramétrage : - verbosity:quiet -version -ver Affiche uniquement les informations de version. Le projet n’est pas généré. @ file Insère des commutateurs de ligne de commande à partir d'un fichier texte. Si vo avez plusieurs fichiers, spécifiez-les séparément. Pour plus d’informations, consultez Fichiers réponse. -warnAsError [ : code [ ;code2 ] -ERR [ :code [ ;code2 ] Liste de codes d’avertissement à traiter co des erreurs. Utilisez un point-virgule ou un virgule pour séparer plusieurs codes d’avertissement. Pour uploads/Ingenierie_Lourd/ informations-de-reference-sur-la-ligne-de-commande-msbuild-visual-studio-microsoft-docs.pdf

  • 22
  • 0
  • 0
Afficher les détails des licences
Licence et utilisation
Gratuit pour un usage personnel Attribution requise
Partager