msbuild(1) General Commands Manual msbuild(1)

msbuild - موتور ساخت مایکروسافت و مونو برای پروژه‌ها

msbuild [options] [project file | directory]

اهداف (targets) مشخص‌شده در فایل پروژه را می‌سازد. اگر فایل پروژه‌ای مشخص نشده باشد، MSBuild دایرکتوری کاری جاری را برای یافتن فایلی که پسوند آن به «proj» ختم می‌شود جستجو کرده و از آن فایل استفاده می‌کند. اگر دایرکتوری مشخص شده باشد، MSBuild آن دایرکتوری را برای یافتن فایل پروژه جستجو خواهد کرد.

/target:<targets>
این اهداف را در پروژه می‌سازد. برای جدا کردن چندین هدف از یک نقطه‌ویرگول یا یک کاما استفاده کنید، یا هر هدف را به طور جداگانه مشخص نمایید. (شکل کوتاه: /t)

مثال:
/target:Resources;Compile

/property:<n>=<v>
تنظیم یا بازنویسی این ویژگی‌های سطح پروژه. <n> نام ویژگی و <v> مقدار آن است. برای جدا کردن چندین ویژگی از یک نقطه‌ویرگول یا یک کاما استفاده کنید، یا هر ویژگی را به طور جداگانه مشخص نمایید. (شکل کوتاه: /p)

مثال:
/property:WarningLevel=2;OutDir=bin/Debug/

/maxcpucount[:n]
نسخه msbuild مونو هنوز از ساخت موازی پشتیبانی نمی‌کند؛ بنابراین این مقدار در درون برنامه به 1 تنظیم می‌شود.

حداکثر تعداد فرایندهای همزمانی را که برای ساخت استفاده می‌شوند مشخص می‌کند. اگر از این سوییچ استفاده نشود، مقدار پیش‌فرض برابر با 1 است. اگر سوییچ بدون مقدار استفاده شود، MSBuild حداکثر تا تعداد پردازنده‌های رایانه استفاده خواهد کرد. (شکل کوتاه: /m[:n])

/toolsversion:<version>
نسخه مجموعه ابزار MSBuild (شامل وظایف، اهداف و غیره) برای استفاده در حین ساخت. این نسخه بر نسخه‌های مشخص‌شده توسط پروژه‌های منفرد برتری خواهد داشت. (شکل کوتاه: /tv)

مثال:
/toolsversion:3.5

/verbosity:<level>
این مقدار از اطلاعات را در گزارش وقایع نمایش می‌دهد. سطوح پرگویی موجود عبارتند از: q[uiet]، m[inimal]، n[ormal]، d[etailed] و diag[nostic]. (شکل کوتاه: /v)

مثال:
/verbosity:quiet

/consoleloggerparameters:<parameters
پارامترهای ثبت‌کننده وقایع کنسول. (شکل کوتاه: /clp)

پارامترهای موجود عبارتند از:

PerformanceSummary      Show time spent in tasks, targets and projects.
Summary                 Show error and warning summary at the end.
NoSummary               Don't show error and warning summary at the end.
ErrorsOnly              Show only errors.
WarningsOnly            Show only warnings.
NoItemAndPropertyList   Don't show list of items and properties at the start of each project build.
ShowCommandLine         Show TaskCommandLineEvent messages
ShowTimestamp           Display the Timestamp as a prefix to any message.
ShowEventId             Show eventId for started events, finished events, and messages
ForceNoAlign            Does not align the text to the size of the console buffer
DisableConsoleColor     Use the default console colors for all logging messages.
DisableMPLogging        Disable the multiprocessor logging style of output when running in non-multiprocessor mode.
EnableMPLogging         Enable the multiprocessor logging style even when running in non-multiprocessor mode. This logging style is on by default.
ForceConsoleColor       Use ANSI console colors even if console does not support it
Verbosity               overrides the /verbosity setting for this logger.

مثال:
/consoleloggerparameters:PerformanceSummary;NoSummary;Verbosity=minimal

/noconsolelogger
غیرفعال کردن ثبت‌کننده پیش‌فرض کنسول و عدم ثبت وقایع در کنسول. (شکل کوتاه: /noconlog)
/fileLogger[n]
خروجی ساخت را در یک فایل ثبت می‌کند. به طور پیش‌فرض این فایل در دایرکتوری جاری قرار داشته و «msbuild[n].log» نام دارد. وقایع مربوط به همه گره‌ها در یک گزارش واحد ترکیب می‌شوند. مکان فایل و سایر پارامترهای مربوط به fileLogger را می‌توان با افزودن سوییچ «/fileLoggerParameters[n]» تعیین کرد. مقدار «n» در صورت وجود می‌تواند رقمی از 1 تا 9 باشد که امکان پیوست حداکثر 10 ثبت‌کننده فایل را فراهم می‌سازد. (شکل کوتاه: /fl[n])
/fileloggerparameters[n]:<parameters>
پارامترهای اضافی را برای ثبت‌کننده‌های فایل فراهم می‌کند. وجود این سوییچ مستلزم سوییچ متناظر /filelogger[n] است. مقدار «n» در صورت وجود می‌تواند رقمی از 1 تا 9 باشد.

گزینه /fileloggerparameters همچنین توسط هر ثبت‌کننده فایل توزیع‌شده به کار می‌رود؛ توضیحات /distributedFileLogger را ببینید. (شکل کوتاه: /flp[n]) همان پارامترهای فهرست‌شده برای ثبت‌کننده کنسول در دسترس هستند. برخی پارامترهای در دسترس دیگر عبارتند از:

LogFile     path to the log file into which the build log will be written.
Append      determines if the build log will be appended to or overwrite the log file. Setting the switch appends the build log to the log file; Not setting the switch overwrites the contents of an existing log file.  The default is not to append to the log file.
Encoding    specifies the encoding for the file, for example, UTF-8, Unicode, or ASCII Default verbosity is Detailed.

مثال‌ها:


/fileLoggerParameters:LogFile=MyLog.log;Append;Verbosity=diagnostic;Encoding=UTF-8


/flp:Summary;Verbosity=minimal;LogFile=msbuild.sum
/flp1:warningsonly;logfile=msbuild.wrn
/flp2:errorsonly;logfile=msbuild.err

/distributedlogger:<central logger>*<forwarding logger>
استفاده از این ثبت‌کننده برای ثبت وقایع MSBuild با اختصاص یک نمونه ثبت‌کننده متفاوت به هر گره. برای مشخص کردن چند ثبت‌کننده، هر یک را جداگانه تعیین کنید. (شکل کوتاه: /dl)


نحو <logger> عبارت است از:
[<logger class>,]<logger assembly>[;<logger parameters>]
نحو <logger class> عبارت است از:
[<partial or full namespace>.]<logger class name>
نحو <logger assembly> عبارت است از:
{<assembly name>[,<strong name>] | <assembly file>}
پارامترهای <logger parameters> اختیاری هستند و دقیقاً همان‌گونه که تایپ شده‌اند به ثبت‌کننده ارسال می‌شوند. (شکل کوتاه: /l)

مثال‌ها:
/dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral
/dl:MyLogger,/mylibs/My.dll*ForwardingLogger,/mylibs/Loggger.dll

/distributedFileLogger
خروجی ساخت را در چندین فایل گزارش، به ازای هر گره MSBuild در یک فایل، ثبت می‌کند. مکان اولیه این فایل‌ها دایرکتوری جاری است. به طور پیش‌فرض این فایل‌ها «MSBuild<nodeid>.log» نامیده می‌شوند. مکان فایل‌ها و سایر پارامترهای مربوط به fileLogger را می‌توان با افزودن سوییچ «/fileLoggerParameters» تعیین کرد.

اگر نام فایل گزارش از طریق سوییچ fileLoggerParameters تنظیم شده باشد، ثبت‌کننده توزیع‌شده از fileName به عنوان الگو استفاده کرده و شناسه گره (node id) را به انتهای این fileName می‌افزاید تا یک فایل گزارش برای هر گره ایجاد کند.

/logger:<logger>
استفاده از این ثبت‌کننده برای ثبت وقایع از MSBuild. برای تعیین چند ثبت‌کننده، هر یک را جداگانه مشخص کنید.
نحو <logger> عبارت است از:
[<logger class>,]<logger assembly>[;<logger parameters>]
نحو <logger class> عبارت است از:
[<partial or full namespace>.]<logger class name>
نحو <logger assembly> عبارت است از:
{<assembly name>[,<strong name>] | <assembly file>}
پارامترهای <logger parameters> اختیاری هستند و دقیقاً همان‌گونه که تایپ شده‌اند به ثبت‌کننده ارسال می‌شوند. (شکل کوتاه: /l)


مثال‌ها:
/logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral
/logger:XMLLogger,/MyLoggers/MyLogger.dll;OutputAsHTML

/binaryLogger[:output.binlog]
تمام وقایع ساخت را در یک فایل باینری فشرده سریال‌سازی می‌کند. به طور پیش‌فرض این فایل در دایرکتوری جاری قرار دارد و «msbuild.binlog» نامیده می‌شود. لاگ باینری شرح مفصلی از فرایند ساخت است که بعداً می‌تواند برای بازسازی لاگ‌های متنی و استفاده توسط سایر ابزارهای تحلیل به کار رود. یک لاگ باینری معمولاً ۱۰ تا ۲۰ برابر کوچک‌تر از دقیق‌ترین لاگ متنی در سطح عیب‌یابی (diagnostic) است، اما حاوی اطلاعات بیشتری است. (شکل کوتاه: /bl)

مثال‌ها:
/bl
/bl:output.binlog
/bl:../../custom.binlog
/binaryLogger

/warnaserror[:code[;code2]]
فهرستی از کدهای هشدار برای در نظر گرفتن به عنوان خطا. برای جدا کردن چندین کد هشدار از یک نقطه‌ویرگول یا یک کاما استفاده کنید. برای در نظر گرفتن تمام هشدارها به عنوان خطا از این سوییچ بدون مقدار استفاده نمایید. (شکل کوتاه: /err[:c;[c2]])

مثال:
/warnaserror:MSB4130

هنگامی که یک هشدار به عنوان خطا در نظر گرفته می‌شود، هدف به اجرای خود ادامه خواهد داد چنان‌که گویی یک هشدار بوده است، اما در نهایت کل ساخت با شکست مواجه خواهد شد.

/warnasmessage[:code[;code2]]
فهرستی از کدهای هشدار برای در نظر گرفتن به عنوان پیام‌های با اهمیت پایین. برای جدا کردن چندین کد هشدار از یک نقطه‌ویرگول یا یک کاما استفاده کنید. (شکل کوتاه: /nowarn[:c;[c2]])

مثال:
/warnasmessage:MSB3026

/ignoreprojectextensions:<extensions>
فهرستی از پسوندها برای نادیده گرفتن در زمان تعیین فایل پروژه مورد نظر جهت ساخت. برای جدا کردن چندین پسوند از یک نقطه‌ویرگول یا یک کاما استفاده کنید. (شکل کوتاه: /ignore)

مثال:
/ignoreprojectextensions:.sln

/nodeReuse:<parameters>
استفاده مجدد از گره‌های MSBuild را فعال یا غیرفعال می‌کند. پارامترها عبارتند از: 
True    Nodes will remain after the build completes and will be reused by subsequent builds (default) False Nodes will not remain after the build completes
(شکل کوتاه: /nr)

مثال:
/nr:true

/preprocess[:file]
یک فایل پروژه منفرد و تجمیعی ایجاد می‌کند که تمام فایل‌های واردشده (imported) در طول ساخت را با مشخص کردن مرزهای آن‌ها به صورت درون‌خطی در می‌آورد. این قابلیت برای فهمیدن اینکه چه فایل‌هایی و از کجا وارد می‌شوند، و چه نقشی در ساخت دارند، می‌تواند مفید باشد. به طور پیش‌فرض خروجی در پنجره کنسول نوشته می‌شود. اگر مسیری برای یک فایل خروجی ارائه شود، خروجی در آن نوشته خواهد شد. (شکل کوتاه: /pp)

مثال:
/pp:out.txt

/detailedsummary
اطلاعات مفصلی را در پایان ساخت درباره پیکربندی‌های ساخته‌شده و نحوه زمان‌بندی آن‌ها روی گره‌ها نمایش می‌دهد. (شکل کوتاه: /ds)
@<file>
وارد کردن تنظیمات خط فرمان از یک فایل متنی. برای مشخص کردن چندین فایل پاسخ، هر فایل پاسخ را به طور جداگانه تعیین کنید.

هرگونه فایل پاسخ با نام «msbuild.rsp» به طور خودکار از مکان‌های زیر دریافت و اعمال می‌شود:

(1) the directory of msbuild.dll
(2) the directory of the first project or solution built
/noautoresponse
هیچ‌یک از فایل‌های MSBuild.rsp به طور خودکار اعمال نشوند. (شکل کوتاه: /noautorsp)
/nologo
بنر راه‌اندازی و پیام حق نشر نمایش داده نشود.
/version
فقط اطلاعات نسخه نمایش داده شود. (شکل کوتاه: /ver)
/help
این پیام راهنمای استفاده نمایش داده شود. (شکل کوتاه: /? یا /h)

mono(1),csc(1)

حق نشر (C) متعلق به شرکت مایکروسافت. تمامی حقوق محفوظ است.