3 xbuild \- Mono's tool to build MSBuild project files
6 [option] [project-file]
8 xbuild can be used to build MSBuild project files. Integrated Development
9 Environments like MonoDevelop and "Microsoft Visual Studio .NET" use msbuild
12 xbuild takes the path of the project or solution file to build, as the main argument.
13 If no file is specified then it tries to build any solution file or project file in
14 the current directory, that has a *proj extension.
18 List of targets to build
20 .B \//property:Name=Value
21 Set or override project properties
24 Custom logger to log build events
26 .B \//verbosity:<level>
27 Logger verbosity level : quiet, minimal, normal, detailed, diagnostic
30 Validate the project file against the schema
32 .B \//validate:<schema>
33 Validate the project file against the specified schema
35 .B \//consoleloggerparameters:<params>
36 Parameters for the console logger : PerfomanceSummary, NoSummary, NoItemAndPropertyList
39 Don't show the initial xbuild banner
45 Display xbuild version
46 .SH ENVIRONMENT VARIABLES
48 .I "XBUILD_EMIT_SOLUTION"
49 If this variable is set, then the project file generated from a solution
52 .I "XBUILD_LOG_REFERENCE_RESOLVER"
53 References are resolved by trying a list of assembly search paths ($(AssemblySearchPaths)).
54 If xbuild is unable to resolve a reference, then it logs details of why the various
55 search paths failed. If this variable is set, then it logs the same even for references
56 that were resolved successfully. These logs show up if the verbosity is set to detailed
59 .I "MSBuildExtensionsPath"
60 MSBuild extensions are usually installed in $(MSBuildExtensionsPath), which xbuild resolves
61 to $prefix/lib/mono/xbuild . When used in Import, like:
63 <Import Project="$(MSBuildExtensionsPath)\\TestTargets.targets"/>
65 xbuild tries various values for the msbuild property $(MSBuildExtensionsPath), in order:
67 1. Paths specified in the environment variable $MSBuildExtensionsPath.
68 2. $XDG_CONFIG_HOME/xbuild/tasks (or Environment.SpecialFolder.ApplicationData)
69 3. $prefix/lib/mono/xbuild (default location)
71 Anywhere else in the project files, $(MSBuildExtensionsPath) will always resolve to the default
72 location. This is a xbuild-only feature.
73 This is also applicable for the properties $(MSBuildExtensionsPath32) and $(MSBuildExtensionsPath64),
74 and the environment variables have the corresponding names - MSBuildExtensionsPath32/64 .
77 If this variable is set, it contains a string of the form
78 "type=foreground,type=.." that specifies which color to use to display
79 errors/warnings etc on some terminals. Type here can be:
82 errors, warnings, messages or events
84 events: These are project/target/task start and end event
89 The possible colors for foreground are:
90 .B black, red, brightred, green, brightgreen, yellow, brightyellow,
91 blue, brightblue, magenta, brightmagenta, cyan, brightcyan, grey,
92 white and brightwhite.
95 For example, you could set this variable from your shell:
98 XBUILD_COLORS=errors=brightred,warnings=blue
102 You can disable the built-in color scheme by setting this variable to
108 Copyright (C) 2009 Novell, Inc (http://www.novell.com)
110 Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.
112 Visit: http://www.mono-project.com for details