.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CPACK" "1" "Aug 31, 2026" "4.4.3" "CMake" .SH "نام (NAME)" cpack \- مرجع خط فرمان ابزار بسته‌بندی CPack .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX cpack [] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp برنامه اجرایی \fBcpack\fP ابزار بسته‌بندی CMake است. این برنامه نصاب‌ها (installers) و بسته‌های سورس‌کد را در قالب‌های متنوعی تولید می‌کند. .sp برای هر قالب نصاب یا بسته، \fBcpack\fP یک بک‌اند (backend) مشخص دارد که «تولیدکننده» (\(dqgenerator\(dq) نامیده می‌شود. یک تولیدکننده وظیفه ایجاد ورودی‌های موردنیاز و فراخوانی ابزارهای ویژه ساخت بسته را بر عهده دارد. این تولیدکننده‌های بسته یا نصاب نباید با تولیدکننده‌های میک‌فایل (makefile) دستور \fBcmake\fP \%<#\:manual:cmake(1)> اشتباه گرفته شوند. .sp تمام تولیدکننده‌های پشتیبانی‌شده در راهنمای \fBcpack\-generators\fP \%<#\:manual:cpack-generators(7)> مشخص شده‌اند. دستور \fBcpack \-\-help\fP فهرستی از تولیدکننده‌های پشتیبانی‌شده برای پلتفرم مقصد را چاپ می‌کند. انتخاب تولیدکننده موردنظر می‌تواند از طریق متغیر \fBCPACK_GENERATOR\fP \%<#\:variable:CPACK_GENERATOR> یا از طریق گزینه خط فرمان \fB\-G\fP انجام شود\&. .sp برنامه \fBcpack\fP توسط یک فایل پیکربندی که به زبان \fBCMake language\fP \%<#\:manual:cmake-language(7)> نوشته شده است هدایت می‌شود\&. مگر اینکه با گزینه خط فرمان \fB\-\-config\fP فایل دیگری انتخاب شده باشد، فایل \fBCPackConfig.cmake\fP در پوشه جاری استفاده خواهد شد. .sp در جریان کاری استاندارد CMake، در صورتی که ماژول \fBCPack\fP \%<#\:module:CPack> در فایل \fBCMakeLists.txt\fP پروژه گنجانده شده باشد، فایل \fBCPackConfig.cmake\fP توسط برنامه اجرایی \fBcmake\fP \%<#\:manual:cmake(1)> تولید می‌گردد. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-G مقدار \fB\fP فهرستی از نام‌های تولیدکننده است که با نقطه-ویرگول جدا شده‌اند \%<#\:cmake-language-lists>\&. ابزار \fBcpack\fP این فهرست را پیمایش کرده و بسته(ها) را بر اساس قالب آن تولیدکننده و مطابق با جزئیات ارائه‌شده در فایل پیکربندی \fBCPackConfig.cmake\fP تولید می‌کند. اگر این گزینه ارائه نشود، متغیر \fBCPACK_GENERATOR\fP \%<#\:variable:CPACK_GENERATOR> مجموعه پیش‌فرض تولیدکننده‌هایی را که استفاده خواهند شد مشخص می‌نماید. .UNINDENT .INDENT 0.0 .TP .B \-C پیکربندی(های) پروژه‌ای را که باید بسته‌بندی شوند مشخص می‌کند (مانند \fBDebug\fP، \fBRelease\fP و غیره)، که در آن \fB\fP فهرستی از پیکربندی‌هاست که با نقطه-ویرگول جدا شده‌اند \%<#\:cmake-language-lists>\&. زمانی که پروژه CMake از یک تولیدکننده چندپیکربندی مانند \fBXcode\fP \%<#\:generator:Xcode> یا Visual Studio \%<#\:visual-studio-generators> استفاده می‌کند، این گزینه برای اعلام اینکه کدام برنامه‌های اجرایی ساخته‌شده باید در بسته گنجانده شوند به \fBcpack\fP نیاز است. کاربر موظف است اطمینان حاصل کند پیکربندی(های) فهرست‌شده، پیش از فراخوانی \fBcpack\fP ساخته شده باشند\&. .UNINDENT .INDENT 0.0 .TP .B \-D = تنظیم یک متغیر CPack. این گزینه هر مقداری را که در فایل ورودی خوانده‌شده توسط \fBcpack\fP برای \fB\fP تنظیم شده باشد، بازنویسی (override) می‌کند\&. .UNINDENT .INDENT 0.0 .TP .B \-\-config تعیین فایل پیکربندی که \fBcpack\fP برای دریافت جزئیات بسته‌بندی می‌خواند. به‌طور پیش‌فرض، فایل \fBCPackConfig.cmake\fP در پوشه جاری استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-V, \-\-verbose اجرای \fBcpack\fP با خروجی پرجزئیات (verbose). این گزینه می‌تواند برای نمایش جزئیات بیشتر از ابزارهای تولید بسته استفاده شود و برای توسعه‌دهندگان پروژه مناسب است. .UNINDENT .INDENT 0.0 .TP .B \-\-debug اجرای \fBcpack\fP با خروجی اشکال‌زدایی (debug). این گزینه عمدتاً برای توسعه‌دهندگان خود \fBcpack\fP در نظر گرفته شده است و معمولاً موردنیاز توسعه‌دهندگان پروژه نیست. .UNINDENT .INDENT 0.0 .TP .B \-\-trace قرار دادن اسکریپت‌های زیربنایی cmake در حالت ردیابی (trace mode). .UNINDENT .INDENT 0.0 .TP .B \-\-trace\-expand قرار دادن اسکریپت‌های زیربنایی cmake در حالت ردیابی بسط‌یافته (expanded trace mode). .UNINDENT .INDENT 0.0 .TP .B \-P بازنویسی/تعریف مقدار متغیر \fBCPACK_PACKAGE_NAME\fP \%<#\:variable:CPACK_PACKAGE_NAME> مورد استفاده برای بسته‌بندی. هر مقداری که برای این متغیر در فایل \fBCPackConfig.cmake\fP تنظیم شده باشد پس از آن نادیده گرفته خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-R بازنویسی/تعریف مقدار متغیر \fBCPACK_PACKAGE_VERSION\fP \%<#\:variable:CPACK_PACKAGE_VERSION> مورد استفاده برای بسته‌بندی. این گزینه مقداری را که در فایل \fBCPackConfig.cmake\fP تنظیم شده یا مقداری را که به‌صورت خودکار از \fBCPACK_PACKAGE_VERSION_MAJOR\fP \%<#\:variable:CPACK_PACKAGE_VERSION_MAJOR>، \fBCPACK_PACKAGE_VERSION_MINOR\fP \%<#\:variable:CPACK_PACKAGE_VERSION_MINOR> و \fBCPACK_PACKAGE_VERSION_PATCH\fP \%<#\:variable:CPACK_PACKAGE_VERSION_PATCH> محاسبه شده است، بازنویسی می‌کند\&. .UNINDENT .INDENT 0.0 .TP .B \-B بازنویسی/تعریف متغیر \fBCPACK_PACKAGE_DIRECTORY\fP \%<#\:variable:CPACK_PACKAGE_DIRECTORY>، که پوشه‌ای را که CPack عملیات بسته‌بندی را در آن انجام می‌دهد کنترل می‌کند. بسته(های) نهایی به‌طور پیش‌فرض در این مکان ایجاد خواهند شد و یک زیرپوشه با نام \fB_CPack_Packages\fP نیز در زیر این پوشه ایجاد می‌شود تا در طول فرایند ساخت بسته به‌عنوان فضای کاری استفاده گردد. .UNINDENT .INDENT 0.0 .TP .B \-\-vendor بازنویسی/تعریف \fBCPACK_PACKAGE_VENDOR\fP \%<#\:variable:CPACK_PACKAGE_VENDOR>\&. .UNINDENT .INDENT 0.0 .TP .B \-\-preset , \-\-preset= استفاده از یک پیش‌تنظیم بسته (\fBpreset\fP \%<#\:manual:cmake-presets(7)>) برای تعیین گزینه‌های بسته. پوشه باینری پروژه از کلید \fBconfigurePreset\fP \%<#\:cmakepresets-packagepresets-configurepreset> استنتاج می‌شود. .sp تغییر یافته در نسخه 4.4: اگر \fB\-\-presets\-file\fP مشخص شده باشد، وجود هیچ‌یک از فایل‌های \fBCMakePresets.json\fP یا \fBCMakeUserPresets.json\fP الزامی نیست. در غیر این صورت، حضور آن‌ها در پوشه ریشه سورس‌کد الزامی است. در نسخه‌های قبلی، این مورد اکیداً الزامی بود. .UNINDENT .INDENT 0.0 .TP .B \-\-presets\-file , \-\-presets\-file= اضافه شده در نسخه 4.4. .sp پیش‌تنظیم‌ها (\fBpresets\fP \%<#\:manual:cmake-presets(7)>) را از \fB\fP مشخص‌شده می‌خواند\&. مسیر مشخص‌شده می‌تواند مطلق یا نسبت به پوشه کاری جاری باشد. اگر \fB\-\-presets\-file\fP داده شود، پیش‌تنظیم‌های تعریف‌شده در \fBCMakePresets.json\fP و \fBCMakeUserPresets.json\fP نادیده گرفته خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-list\-presets فهرست کردن پیش‌تنظیم‌های بسته در دسترس. .sp تغییر یافته در نسخه 4.4: اگر \fB\-\-presets\-file\fP مشخص شده باشد، وجود هیچ‌یک از فایل‌های \fBCMakePresets.json\fP یا \fBCMakeUserPresets.json\fP الزامی نیست و تنها پیش‌تنظیم‌های تعریف‌شده در \fB\fP داده‌شده فهرست خواهند شد. در غیر این صورت، حضور آن‌ها در پوشه سطح بالای سورس‌کد الزامی است. در نسخه‌های پیشین، این مورد اکیداً الزامی بود. .UNINDENT .INDENT 0.0 .TP .B \-version[=json\-v1] [], \-\-version[=json\-v1] [], /V[=json\-v1] [], /version[=json\-v1] [] نمایش نام برنامه/نسخه و خروج. اگر \fBjson\-v1\fP مشخص شود، اطلاعات تفصیلی نسخه را در قالب JSON چاپ می‌کند. خروجی JSON حاوی اطلاعات نسخه‌های CMake و وابستگی‌های آن است. در صورت ارائه \fB\fP، خروجی در فایل مشخص‌شده چاپ خواهد شد. .sp قالب خروجی JSON به‌صورت ماشین‌خوان توسط \fBthis JSON schema\fP شرح داده شده است\&. .UNINDENT .INDENT 0.0 .TP .B \-h, \-H, \-\-help, \-help, \-usage, /? چاپ اطلاعات راهنمای استفاده و خروج. .sp بخش راهنما رابط خط فرمان پایه و گزینه‌های آن را توصیف می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-help [] چاپ راهنما برای یک کلیدواژه CMake. .sp مقدار \fB\fP می‌تواند یک ویژگی (property)، متغیر، دستور، خط‌مشی (policy)، تولیدکننده یا ماژول باشد. .sp مدخل راهنمای مربوطه برای \fB\fP در قالب متن خوانا برای انسان چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .sp تغییر یافته در نسخه 3.28: پیش از CMake 3.28، این گزینه تنها از نام‌های دستورات پشتیبانی می‌کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-full [] چاپ تمام راهنماها و خروج. .sp تمامی صفحات راهنما در یک قالب متنی خوانا چاپ می‌شوند. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-manual [] چاپ یک صفحه راهنما و خروج. .sp راهنمای مشخص‌شده در یک قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-manual\-list [] فهرست کردن راهنماهای در دسترس و خروج. .sp این فهرست شامل تمامی راهنماهایی است که می‌توان با استفاده از گزینه \fB\-\-help\-manual\fP و به‌دنبال آن نام راهنما به آن‌ها دسترسی پیدا کرد. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-command [] چاپ راهنما برای یک دستور و خروج. .sp مدخل راهنمای \fBcmake\-commands(7)\fP \%<#\:manual:cmake-commands(7)> برای \fB\fP در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-command\-list [] فهرست کردن دستورات دارای راهنما و خروج. .sp این فهرست شامل تمامی دستوراتی است که می‌توان با استفاده از گزینه \fB\-\-help\-command\fP و به‌دنبال آن نام دستور به راهنمای آن‌ها دست یافت. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-commands [] چاپ راهنمای cmake\-commands و خروج. .sp راهنمای \fBcmake\-commands(7)\fP \%<#\:manual:cmake-commands(7)> در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-module [] چاپ راهنما برای یک ماژول و خروج. .sp مدخل راهنمای \fBcmake\-modules(7)\fP \%<#\:manual:cmake-modules(7)> برای \fB\fP در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-module\-list [] فهرست کردن ماژول‌های دارای راهنما و خروج. .sp این فهرست شامل تمامی ماژول‌هایی است که می‌توان با استفاده از گزینه \fB\-\-help\-module\fP و به‌دنبال آن نام ماژول به راهنمای آن‌ها دست یافت. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-modules [] چاپ راهنمای cmake\-modules و خروج. .sp راهنمای \fBcmake\-modules(7)\fP \%<#\:manual:cmake-modules(7)> در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-policy [] چاپ راهنما برای یک خط‌مشی (policy) و خروج. .sp مدخل راهنمای \fBcmake\-policies(7)\fP \%<#\:manual:cmake-policies(7)> برای \fB\fP در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-policy\-list [] فهرست کردن خط‌مشی‌های دارای راهنما و خروج. .sp این فهرست شامل تمامی خط‌مشی‌هایی است که می‌توان با استفاده از گزینه \fB\-\-help\-policy\fP و به‌دنبال آن نام خط‌مشی به راهنمای آن‌ها دسترسی پیدا کرد. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-policies [] چاپ راهنمای cmake\-policies و خروج. .sp راهنمای \fBcmake\-policies(7)\fP \%<#\:manual:cmake-policies(7)> در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-property [] چاپ راهنما برای یک ویژگی (property) و خروج. .sp مدخل راهنمای \fBcmake\-properties(7)\fP \%<#\:manual:cmake-properties(7)> برای \fB\fP در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-property\-list [] فهرست کردن ویژگی‌های دارای راهنما و خروج. .sp این فهرست شامل تمامی ویژگی‌هایی است که می‌توان با استفاده از گزینه \fB\-\-help\-property\fP و به‌دنبال آن نام ویژگی به راهنمای آن‌ها دست یافت. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-properties [] چاپ راهنمای cmake\-properties و خروج. .sp راهنمای \fBcmake\-properties(7)\fP \%<#\:manual:cmake-properties(7)> در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-variable [] چاپ راهنما برای یک متغیر و خروج. .sp مدخل راهنمای \fBcmake\-variables(7)\fP \%<#\:manual:cmake-variables(7)> برای \fB\fP در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-variable\-list [] فهرست کردن متغیرهای دارای راهنما و خروج. .sp این فهرست شامل تمامی متغیرهایی است که می‌توان با استفاده از گزینه \fB\-\-help\-variable\fP و به‌دنبال آن نام متغیر به راهنمای آن‌ها دسترسی پیدا کرد. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-variables [] چاپ راهنمای cmake\-variables و خروج. .sp راهنمای \fBcmake\-variables(7)\fP \%<#\:manual:cmake-variables(7)> در قالب متنی خوانا چاپ می‌شود. در صورت ارائه نام \fB\fP، خروجی در آن فایل چاپ خواهد شد. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp منابع زیر برای دریافت راهنما در خصوص استفاده از CMake در دسترس هستند: .INDENT 0.0 .TP .B صفحه اصلی \% .sp نقطه آغاز اصلی برای یادگیری در مورد CMake. .TP .B مستندات آنلاین و منابع جامعه کاربری \% .sp پیوندها به مستندات و منابع جامعه کاربری موجود را می‌توان در این صفحه وب یافت. .TP .B تالار گفتگوی Discourse \% .sp تالار گفتگوی Discourse میزبان بحث‌ها و پرسش‌ها پیرامون CMake است. .UNINDENT .SH "حق نشر (COPYRIGHT)" 2000-2026 Kitware, Inc. and Contributors .\" End of generated man page.