DUB-BUILD(1)               The D Language Foundation              DUB-BUILD(1)

نام (NAME)
       dub-build - ساخت یک بسته (به‌طور پیش‌فرض از بسته اصلی در دایرکتوری کاری
       فعلی استفاده می‌کند)

خلاصه دستور (SYNOPSIS)
       dub build [<package>[@<version-spec>]] OPTIONS...

توضیحات (DESCRIPTION)
       یک بسته را می‌سازد (به‌طور پیش‌فرض از بسته اصلی در دایرکتوری کاری فعلی
       استفاده می‌کند).

گزینه‌ها (OPTIONS)
       --temp-build
           در صورت امکان، پروژه را در پوشه موقت (temp) می‌سازد.

       --rdmd
           استفاده از rdmd به جای فراخوانی مستقیم کامپایلر.

       -f, --force
           کامپایل مجدد را اجبار می‌کند حتی اگر هدف به‌روز باشد.

       -y, --yes
           پاسخ «بله» خودکار به اعلان‌ها. فرض کردن "yes" به عنوان پاسخ به تمام
           اعلان‌های تعاملی.

       -n, --non-interactive
           وارد حالت تعاملی نمی‌شود.

       --deep
           ساخت تمام وابستگی‌ها، حتی زمانی که هدف اصلی یک کتابخانه ایستا
           (static library) باشد.

       --dest=VALUE
           دایرکتوری پایه‌ای که مصنوعات خروجی در آن قرار خواهند گرفت.

       -b, --build=VALUE
           نوع ساختی که باید انجام شود را مشخص می‌کند. توجه داشته باشید که
           مقداردهی متغیر محیطی DFLAGS نوع ساخت را با پرچم‌های سفارشی بازنویسی
           خواهد کرد.  نام‌های ممکن:
             debug, plain, release, release-debug, release-nobounds, unittest,
           profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov,
           unittest-cov-ctfe, syntax و انواع سفارشی

       -c, --config=VALUE
           پیکربندی مشخص‌شده را می‌سازد. پیکربندی‌ها را می‌توان در dub.json تعریف
           کرد.

       --override-config=VALUE
           از پیکربندی مشخص‌شده برای یک وابستگی خاص استفاده می‌کند. می‌تواند
           چندین بار مشخص شود.  قالب: --override-config=<dependency>/<config>

       --compiler=VALUE
           باینری کامپایلر مورد استفاده را مشخص می‌کند (می‌تواند یک مسیر باشد).
           پیشوندها و پسوندهای دلخواه شناسه‌های زیر تشخیص داده شده (مانند ldc2
           یا dmd-2.063) و با نوع کامپایلر مناسب تطبیق داده می‌شوند:
             dmd, gdc, ldc, gdmd, ldmd

       -a, --arch=VALUE
           اجبار به استفاده از یک معماری دیگر (مانند x86 یا x86_64).

       -d, --debug=VALUE
           شناسه نسخهٔ `debug` مشخص‌شده را هنگام ساخت تعریف می‌کند - می‌تواند
           چندین بار استفاده شود.

       --d-version=VALUE
           شناسهٔ `version` مشخص‌شده را هنگام ساخت تعریف می‌کند - می‌تواند چندین
           بار استفاده شود.  با احتیاط استفاده کنید؛ با قدرت بسیار، مسئولیت
           بسیار می‌آید! برای نسخه‌های پرکاربرد یا ترکیبی و نسخه‌هایی که وابسته‌ها
           باید بتوانند استفاده کنند، پیکربندی‌هایی در بسته خود ایجاد کنید.

       --nodeps
           پیش از ساخت، وابستگی‌های ناموجود را حل‌وفصل نمی‌کند.

       --build-mode=VALUE
           نحوه فراخوانی کامپایلر و پیونددهنده (linker) را مشخص می‌کند. مقادیر
           معتبر:
             separate (پیش‌فرض), allAtOnce, singleFile

       --single
           نام بسته را به عنوان یک نام فایل در نظر می‌گیرد. فایل باید حاوی یک
           یادداشت دستورالعمل بسته (package recipe comment) باشد.

       --force-remove
           گزینه منسوخ‌شده‌ای که هیچ کاری انجام نمی‌دهد.

       --filter-versions
           [آزمایشی] شناسه‌های version و شناسه‌های debug version را فیلتر می‌کند
           تا کارایی حافظه پنهان (cache) ساخت بهبود یابد.

       --combined
           تلاش می‌کند تا کل پروژه را در یک بار اجرای کامپایلر بسازد.

       --print-builds
           فهرست انواع ساخت‌های موجود را چاپ می‌کند.

       --print-configs
           فهرست پیکربندی‌های موجود را چاپ می‌کند.

       --print-platform
           شناسه‌های مربوط به بستر (platform) ساخت فعلی را به همان صورت مورد
           استفاده در فیلدهای build در dub.json چاپ می‌کند.

       --parallel
           در صورت امکان، چندین نمونه از کامپایلر را به‌طور موازی اجرا می‌کند.

   گزینه‌های عمومی (COMMON OPTIONS)
       به dub(1) مراجعه کنید.

وضعیت خروج (EXIT STATUS)
       0      دستور DUB با موفقیت اجرا شد.

       1      خطاهای نحوه استفاده، پرچم‌های ناشناخته خط فرمان.

       2      بسته یافت نشد، بارگیری بسته ناموفق بود، خطاهای متفرقه.

فایل‌ها (FILES)
       dub.sdl, dub.json

نویسندگان (AUTHORS)
       حق نشر (c) ۱۹۹۹-۲۰۲۶ متعلق به The D Language Foundation

مستندات برخط (ONLINE DOCUMENTATION)
       http://code.dlang.org/docs/commandline
       <http://code.dlang.org/docs/commandline>

همچنین ببینید (SEE ALSO)
       dub(1), dub-run(1), dub-test(1), rdmd(1)

The D Language Foundation         2026-08-16                      DUB-BUILD(1)