.TH DUB-BUILD 1 "2026-08-16" "The D Language Foundation" "The D Language Foundation"
.SH "نام (NAME)"
dub-build \- ساخت یک بسته (به‌طور پیش‌فرض از بسته اصلی در دایرکتوری کاری فعلی استفاده می‌کند)
.SH "خلاصه دستور (SYNOPSIS)"
\fBdub build \fR[<\fIpackage\fR>[@<\fIversion-spec\fR>]] \fIOPTIONS\&.\&.\&.\fR
.SH "توضیحات (DESCRIPTION)"
یک بسته را می‌سازد (به‌طور پیش‌فرض از بسته اصلی در دایرکتوری کاری فعلی استفاده می‌کند).
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-temp\-build\fR
.RS 4
در صورت امکان، پروژه را در پوشه موقت (temp) می‌سازد.
.RE
.PP
\fB\-\-rdmd\fR
.RS 4
استفاده از rdmd به جای فراخوانی مستقیم کامپایلر.
.RE
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
کامپایل مجدد را اجبار می‌کند حتی اگر هدف به‌روز باشد.
.RE
.PP
\fB\-y\fR, \fB\-\-yes\fR
.RS 4
پاسخ «بله» خودکار به اعلان‌ها. فرض کردن "yes" به عنوان پاسخ به تمام اعلان‌های تعاملی.
.RE
.PP
\fB\-n\fR, \fB\-\-non\-interactive\fR
.RS 4
وارد حالت تعاملی نمی‌شود.
.RE
.PP
\fB\-\-deep\fR
.RS 4
ساخت تمام وابستگی‌ها، حتی زمانی که هدف اصلی یک کتابخانه ایستا (static library) باشد.
.RE
.PP
\fB\-\-dest\fR=\fIVALUE\fR
.RS 4
دایرکتوری پایه‌ای که مصنوعات خروجی در آن قرار خواهند گرفت.
.RE
.PP
\fB\-b\fR, \fB\-\-build\fR=\fIVALUE\fR
.RS 4
نوع ساختی که باید انجام شود را مشخص می‌کند. توجه داشته باشید که مقداردهی متغیر محیطی DFLAGS نوع ساخت را با پرچم‌های سفارشی بازنویسی خواهد کرد.
نام‌های ممکن:
  debug, plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov, unittest-cov-ctfe, syntax و انواع سفارشی
.RE
.PP
\fB\-c\fR, \fB\-\-config\fR=\fIVALUE\fR
.RS 4
پیکربندی مشخص‌شده را می‌سازد. پیکربندی‌ها را می‌توان در dub.json تعریف کرد.
.RE
.PP
\fB\-\-override\-config\fR=\fIVALUE\fR
.RS 4
از پیکربندی مشخص‌شده برای یک وابستگی خاص استفاده می‌کند. می‌تواند چندین بار مشخص شود.
قالب: --override-config=<dependency>/<config>
.RE
.PP
\fB\-\-compiler\fR=\fIVALUE\fR
.RS 4
باینری کامپایلر مورد استفاده را مشخص می‌کند (می‌تواند یک مسیر باشد).
پیشوندها و پسوندهای دلخواه شناسه‌های زیر تشخیص داده شده (مانند ldc2 یا dmd-2.063) و با نوع کامپایلر مناسب تطبیق داده می‌شوند:
  dmd, gdc, ldc, gdmd, ldmd
.RE
.PP
\fB\-a\fR, \fB\-\-arch\fR=\fIVALUE\fR
.RS 4
اجبار به استفاده از یک معماری دیگر (مانند x86 یا x86_64).
.RE
.PP
\fB\-d\fR, \fB\-\-debug\fR=\fIVALUE\fR
.RS 4
شناسه نسخهٔ `debug` مشخص‌شده را هنگام ساخت تعریف می‌کند - می‌تواند چندین بار استفاده شود.
.RE
.PP
\fB\-\-d\-version\fR=\fIVALUE\fR
.RS 4
شناسهٔ `version` مشخص‌شده را هنگام ساخت تعریف می‌کند - می‌تواند چندین بار استفاده شود.
با احتیاط استفاده کنید؛ با قدرت بسیار، مسئولیت بسیار می‌آید! برای نسخه‌های پرکاربرد یا ترکیبی و نسخه‌هایی که وابسته‌ها باید بتوانند استفاده کنند، پیکربندی‌هایی در بسته خود ایجاد کنید.
.RE
.PP
\fB\-\-nodeps\fR
.RS 4
پیش از ساخت، وابستگی‌های ناموجود را حل‌وفصل نمی‌کند.
.RE
.PP
\fB\-\-build\-mode\fR=\fIVALUE\fR
.RS 4
نحوه فراخوانی کامپایلر و پیونددهنده (linker) را مشخص می‌کند. مقادیر معتبر:
  separate (پیش‌فرض), allAtOnce, singleFile
.RE
.PP
\fB\-\-single\fR
.RS 4
نام بسته را به عنوان یک نام فایل در نظر می‌گیرد. فایل باید حاوی یک یادداشت دستورالعمل بسته (package recipe comment) باشد.
.RE
.PP
\fB\-\-force\-remove\fR
.RS 4
گزینه منسوخ‌شده‌ای که هیچ کاری انجام نمی‌دهد.
.RE
.PP
\fB\-\-filter\-versions\fR
.RS 4
[آزمایشی] شناسه‌های version و شناسه‌های debug version را فیلتر می‌کند تا کارایی حافظه پنهان (cache) ساخت بهبود یابد.
.RE
.PP
\fB\-\-combined\fR
.RS 4
تلاش می‌کند تا کل پروژه را در یک بار اجرای کامپایلر بسازد.
.RE
.PP
\fB\-\-print\-builds\fR
.RS 4
فهرست انواع ساخت‌های موجود را چاپ می‌کند.
.RE
.PP
\fB\-\-print\-configs\fR
.RS 4
فهرست پیکربندی‌های موجود را چاپ می‌کند.
.RE
.PP
\fB\-\-print\-platform\fR
.RS 4
شناسه‌های مربوط به بستر (platform) ساخت فعلی را به همان صورت مورد استفاده در فیلدهای build در dub.json چاپ می‌کند.
.RE
.PP
\fB\-\-parallel\fR
.RS 4
در صورت امکان، چندین نمونه از کامپایلر را به‌طور موازی اجرا می‌کند.
.RE
.SS "گزینه‌های عمومی (COMMON OPTIONS)"
به \fBdub\fR(1) مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
.BR 0
دستور DUB با موفقیت اجرا شد.
.TP
.BR 1
خطاهای نحوه استفاده، پرچم‌های ناشناخته خط فرمان.
.TP
.BR 2
بسته یافت نشد، بارگیری بسته ناموفق بود، خطاهای متفرقه.
.SH "فایل‌ها (FILES)"
\fIdub\&.sdl\fR, \fIdub\&.json\fR
.SH "نویسندگان (AUTHORS)"
حق نشر (c) ۱۹۹۹-۲۰۲۶ متعلق به The D Language Foundation
.SH "مستندات برخط (ONLINE DOCUMENTATION)"
.UR http://code.dlang.org/docs/commandline
http://code.dlang.org/docs/commandline
.UE
.SH "همچنین ببینید (SEE ALSO)"
\fBdub\fR(1), \fBdub-run\fR(1), \fBdub-test\fR(1), \fBrdmd\fR(1)