.\" 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 "CCMAKE" "1" "Aug 31, 2026" "4.4.3" "CMake" .SH "نام (NAME)" ccmake \- مرجع خط فرمان رابط کاربری مبتنی بر Curses برای CMake .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX ccmake [] \-B [\-S ] ccmake [] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp فایل اجرایی \fBccmake\fP رابط کاربری متنی مبتنی بر Curses برای CMake است. تنظیمات پیکربندی پروژه را می‌توان به صورت تعاملی از طریق این رابط مشخص کرد. هنگام اجرای برنامه، دستورالعمل‌های مختصری در پایین ترمینال ارائه می‌شود. .sp سامانه CMake یک تولیدکننده سیستم ساخت چندپلتفرمی است. پروژه‌ها فرایند ساخت خود را با فایل‌های لیست CMake مستقل از پلتفرم که در هر پوشه از درخت منبع با نام \fBCMakeLists.txt\fP قرار دارند، مشخص می‌کنند. کاربران با استفاده از CMake برای ابزار بومی پلتفرم خود یک سیستم ساخت تولید کرده و سپس پروژه را می‌سازند. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-S مسیر دایرکتوری ریشه پروژه CMake برای ساخت. .UNINDENT .INDENT 0.0 .TP .B \-B مسیر دایرکتوری که CMake به عنوان ریشه دایرکتوری ساخت استفاده خواهد کرد. .sp اگر دایرکتوری از قبل وجود نداشته باشد، CMake آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-C پیش‌بارگذاری یک اسکریپت برای مقداردهی اولیه حافظه موقت (کش). .sp هنگامی که CMake برای نخستین بار در یک درخت ساخت خالی اجرا می‌شود، یک فایل \fBCMakeCache.txt\fP ایجاد کرده و آن را با تنظیمات قابل سفارشی‌سازی برای پروژه پر می‌کند. این گزینه می‌تواند برای مشخص کردن فایلی استفاده شود که مدخل‌های کش قبل از اولین بررسی فایل‌های لیست CMake پروژه از آن بارگذاری شوند. مدخل‌های بارگذاری‌شده بر مقادیر پیش‌فرض پروژه اولویت دارند. فایل داده‌شده باید یک اسکریپت CMake شامل دستورات \fBset()\fP \%<#\:command:set> باشد که از گزینه \fBCACHE\fP استفاده می‌کنند، نه یک فایل با قالب کش. .sp ارجاعات به \fBCMAKE_SOURCE_DIR\fP \%<#\:variable:CMAKE_SOURCE_DIR> و \fBCMAKE_BINARY_DIR\fP \%<#\:variable:CMAKE_BINARY_DIR> در داخل اسکریپت به درخت منبع و ساخت سطح بالا ارزیابی می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-D :=, \-D = ایجاد یا به‌روزرسانی یک مدخل \fBCACHE\fP در CMake. .sp هنگامی که CMake برای نخستین بار در یک درخت ساخت خالی اجرا می‌شود، یک فایل \fBCMakeCache.txt\fP ایجاد کرده و آن را با تنظیمات قابل سفارشی‌سازی برای پروژه پر می‌کند. این گزینه می‌تواند برای مشخص کردن تنظیمی استفاده شود که بر مقدار پیش‌فرض پروژه اولویت دارد. این گزینه می‌تواند برای هر تعداد مدخل \fBCACHE\fP که لازم باشد تکرار شود. .sp اگر بخش \fB:\fP داده شود، باید یکی از انواعی باشد که توسط مستندات دستور \fBset()\fP \%<#\:command:set> برای ساختار \fBCACHE\fP آن مشخص شده است. اگر بخش \fB:\fP حذف شود، در صورتی که مدخل از قبل با نوع مشخصی وجود نداشته باشد، بدون نوع ایجاد خواهد شد. اگر دستوری در پروژه نوع را به \fBPATH\fP یا \fBFILEPATH\fP تنظیم کند، مقدار \fB\fP به یک مسیر مطلق تبدیل خواهد شد. .sp این گزینه همچنین می‌تواند به صورت یک آرگومان منفرد داده شود: \fB\-D:=\fP یا \fB\-D=\fP\&. .sp رشته راهنمای کش \fBHELPSTRING\fP \%<#\:prop_cache:HELPSTRING> به شرح زیر مقداردهی می‌شود: .INDENT 7.0 .IP \(bu 2 اگر مدخل کش برای CMake شناخته‌شده باشد، رشته راهنمای آن به یک خط توضیح از متغیر تنظیم می‌شود. .sp افزوده شده در نسخه 4.4. .IP \(bu 2 در غیر این صورت، رشته راهنمای آن روی مقدار پیش‌فرض عمومی تنظیم می‌شود: \fBNo help, variable specified on the command line.\fP .UNINDENT .sp توجه به این نکته مهم است که ترتیب آرگومان‌های \fB\-C\fP و \fB\-D\fP اهمیت دارد. آن‌ها به ترتیبی که فهرست شده‌اند اعمال می‌شوند، به طوری که آخرین آرگومان بر آرگومان‌های قبلی اولویت دارد. به عنوان مثال، اگر \fB\-DCMAKE_BUILD_TYPE=Debug\fP را مشخص کنید و سپس یک آرگومان \fB\-C\fP با فایلی قرار دهید که دستور زیر را فراخوانی می‌کند: .INDENT 7.0 .INDENT 3.5 .sp .EX set(CMAKE_BUILD_TYPE \(dqRelease\(dq CACHE STRING \(dq\(dq FORCE) .EE .UNINDENT .UNINDENT .sp آنگاه آرگومان \fB\-C\fP اولویت خواهد داشت و \fBCMAKE_BUILD_TYPE\fP روی \fBRelease\fP تنظیم می‌شود. با این حال، اگر آرگومان \fB\-D\fP پس از آرگومان \fB\-C\fP بیاید، مقدار آن روی \fBDebug\fP تنظیم خواهد شد. .sp اگر یک فراخوانی \fBset(... CACHE ...)\fP در فایل \fB\-C\fP از \fBFORCE\fP استفاده نکند و یک آرگومان \fB\-D\fP همان متغیر را تنظیم کند، به دلیل ماهیت فراخوانی‌های \fBset(... CACHE ...)\fP بدون \fBFORCE\fP، آرگومان \fB\-D\fP بدون توجه به ترتیب اولویت خواهد داشت. .UNINDENT .INDENT 0.0 .TP .B \-U حذف مدخل‌های منطبق از \fBCACHE\fP در CMake. .sp این گزینه می‌تواند برای حذف یک یا چند متغیر از فایل \fBCMakeCache.txt\fP استفاده شود؛ الگوهای تطبیق با استفاده از \fB*\fP و \fB?\fP پشتیبانی می‌شوند. این گزینه می‌تواند برای هر تعداد مدخل \fBCACHE\fP که لازم باشد تکرار شود. .sp با احتیاط استفاده کنید، ممکن است فایل \fBCMakeCache.txt\fP شما را غیرقابل استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-G مشخص کردن یک تولیدکننده سیستم ساخت (Generator). .sp سامانه CMake ممکن است در برخی پلتفرم‌ها از چندین سیستم ساخت بومی پشتیبانی کند. یک تولیدکننده مسئول تولید یک سیستم ساخت خاص است. نام‌های مجاز تولیدکننده‌ها در راهنمای \fBcmake\-generators(7)\fP \%<#\:manual:cmake-generators(7)> مشخص شده است. .sp در صورت عدم تعیین، CMake متغیر محیطی \fBCMAKE_GENERATOR\fP \%<#\:envvar:CMAKE_GENERATOR> را بررسی می‌کند و در غیر این صورت به گزینه پیش‌فرض توکار بازمی‌گردد. .UNINDENT .INDENT 0.0 .TP .B \-T مشخصات مجموعه‌ابزار (Toolset) برای تولیدکننده، در صورت پشتیبانی. .sp برخی از تولیدکننده‌های CMake از مشخصات مجموعه‌ابزار پشتیبانی می‌کنند تا به سیستم ساخت بومی نحوه انتخاب کامپایلر را اعلام کنند. برای جزئیات به متغیر \fBCMAKE_GENERATOR_TOOLSET\fP \%<#\:variable:CMAKE_GENERATOR_TOOLSET> مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-A مشخص کردن نام پلتفرم در صورت پشتیبانی توسط تولیدکننده. .sp برخی تولیدکننده‌های CMake از تعیین نام پلتفرم برای سیستم ساخت بومی به منظور انتخاب کامپایلر یا SDK پشتیبانی می‌کنند. برای جزئیات به متغیر \fBCMAKE_GENERATOR_PLATFORM\fP \%<#\:variable:CMAKE_GENERATOR_PLATFORM> مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-toolchain افزوده شده در نسخه 3.21. .sp مشخص کردن فایل زنجیره‌ابزار (toolchain) کامپایل متقابل (cross-compiling)، معادل با تنظیم متغیر \fBCMAKE_TOOLCHAIN_FILE\fP \%<#\:variable:CMAKE_TOOLCHAIN_FILE>\&. مسیرهای نسبی نسبت به دایرکتوری ساخت تفسیر می‌شوند، و در صورت پیدا نشدن، نسبت به دایرکتوری منبع سنجیده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-install\-prefix افزوده شده در نسخه 3.21. .sp مشخص کردن دایرکتوری نصب، مورد استفاده توسط متغیر \fBCMAKE_INSTALL_PREFIX\fP \%<#\:variable:CMAKE_INSTALL_PREFIX>\&. باید یک مسیر مطلق باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-project\-file افزوده شده در نسخه 4.0. .sp مشخص کردن نام فایل پروژه جایگزین. .sp این گزینه فایل سطح بالایی را که توسط CMake هنگام پیکربندی یک پروژه پردازش می‌شود، و همچنین فایل پردازش‌شده توسط \fBadd_subdirectory()\fP \%<#\:command:add_subdirectory> را تعیین می‌کند. .sp به طور پیش‌فرض، این مقدار \fBCMakeLists.txt\fP است. در صورت تنظیم روی هر مقدار دیگر، هر زمان که فایل مشخص‌شده در زیردایرکتوری پروژه پیدا نشود، از \fBCMakeLists.txt\fP به عنوان جایگزین استفاده خواهد شد. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این ویژگی برای استفاده موقت توسعه‌دهندگان در طول دوره گذار تدریجی در نظر گرفته شده است و برای انتشار محصول نهایی کاربرد ندارد. هر زمان که فایل پروژه چیزی غیر از \fBCMakeLists.txt\fP باشد، CMake همواره یک هشدار صادر می‌کند. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-W ارتقای دسته عیب‌یابی مشخص‌شده (و زیردسته‌های آن) به حداقل سطح شدت \fBWARN\fP\&. توجه داشته باشید که این گزینه بر پیام‌های عیب‌یابی که از قبل روی سطح شدت بالاتری تنظیم شده‌اند تاثیری ندارد. .sp برای فهرستی از مقادیر پذیرفته‌شده برای \fB\fP، به راهنمای \fBcmake\-diagnostics(7)\fP \%<#\:manual:cmake-diagnostics(7)> مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-Wno\- Disable (ignore) all diagnostics of the specified category, including any child categories. .UNINDENT .INDENT 0.0 .TP .B \-Werror= Promote the specified diagnostic category (and any children) to at least \fBSEND_ERROR\fP severity. Note that this has no effect on diagnostics already set to a higher severity. .UNINDENT .INDENT 0.0 .TP .B \-Wno\-error= کاهش دسته عیب‌یابی مشخص‌شده (و تمام زیردسته‌ها) به حداکثر سطح شدت \fBWARN\fP\&. توجه داشته باشید که این گزینه بر پیام‌های عیب‌یابی که از قبل روی سطح شدت پایین‌تری تنظیم شده‌اند تاثیری ندارد. .UNINDENT .INDENT 0.0 .TP .B \-Wdev, \-Wno\-dev منسوخ شده از نسخه 4.4. .sp مترادف‌های سازگاری برای \fB\-Wauthor\fP / \fB\-Wno\-author\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 در قالبی خوانا برای ماشین توسط \fBاین طرحواره JSON\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 تالار گفتگوی دیسکورس میزبان بحث‌ها و پرسش‌ها درباره CMake است. .UNINDENT .SH "حق نشر (COPYRIGHT)" 2000-2026 Kitware, Inc. and Contributors .\" End of generated man page.