| Foundry(1) | General Commands Manual | Foundry(1) |
نام (NAME)
foundry - یک محیط توسعه خط فرمان
خلاصه دستور (SYNOPSIS)
foundry [OPTION]... COMMAND [COMMAND-OPTIONS]...
توضیحات (DESCRIPTION)
foundry یک محیط توسعه و سامانه ساخت است که برای میزکار GNOME طراحی شده است. این ابزار مدیریت پروژه، یکپارچه‌سازی خط لوله ساخت (build pipeline)، مدیریت SDK و ابزارهای توسعه گوناگونی را برای ساخت برنامه‌ها و کتابخانه‌ها فراهم می‌کند.
دستورها (COMMANDS)
دستورهای پروژه (Project Commands)
- init
- راه‌اندازی یک پروژه جدید در دایرکتوری جاری.
دستورهای محیط (Environment Commands)
- enter
- ورود به محیط پروژه در دایرکتوری جاری.
- devenv [-- command]
- ورود به محیط ساخت پروژه، مشابه با خط لوله ساخت (build pipeline).
- shell [-- command]
- راه‌اندازی یک شل در محیط پروژه یا اجرای command.
دستورهای فایل (File Commands)
- guess-language
- تشخیص زبان برنامه‌نویسی یک فایل.
- grep
- جستجوی فایل‌ها با استفاده از سازوکار جستجو و جایگزینی Foundry.
- symbol-tree FILE
- فهرست کردن نمادهای موجود در FILE به‌صورت درختی.
- find-symbol-at FILE LINE LINE_OFFSET
- یافتن نماد در یک موقعیت مشخص در FILE در سطر LINE و آفست LINE_OFFSET (شروع هر دو از ۱). از --tree برای چاپ نمادهای والد به‌صورت درختی استفاده کنید.
- نمایه‌سازی FILE با استفاده از سرویس ctags و ارسال داده‌های ctags به stdout..SS "دستورات ساخت (Build Commands)"
- build
- پایپ‌لاین ساخت فعلی را می‌سازد.
- run [-- command]
- یک دستور پروژه را در محیط زمان اجرا (runtime) اجرا می‌کند.
دستورات پایپ‌لاین (Pipeline Commands)
- pipeline info
- اطلاعات مربوط به پایپ‌لاین ساخت را نمایش می‌دهد.
- pipeline flags
- فلگ‌های ساخت را برای پایپ‌لاین ساخت نمایش می‌دهد.
- pipeline targets
- اهداف ساخت (targets) را برای پایپ‌لاین ساخت فهرست می‌کند.
- pipeline which
- نشان می‌دهد کدام پایپ‌لاین فعال است.
- pipeline invalidate
- حافظه موقت (کَش) پایپ‌لاین را باطل می‌کند.
- pipeline link PHASE PROJECT_DIRECTORY LINKED_PHASE
- یک فضای کاری را به پایپ‌لاین ساخت پیوند می‌دهد. این مرحله در PHASE از پایپ‌لاین فعلی اجرا شده و پایپ‌لاین پیوندداده‌شده را در LINKED_PHASE اجرا می‌کند.
- pipeline unlink PHASE PROJECT_DIRECTORY
- پیوند یک فضای کاری را از پایپ‌لاین ساخت لغو می‌کند. مدخل‌های منطبق با PHASE و PROJECT_DIRECTORY را از فضاهای کاری پیوندداده‌شده حذف می‌کند.
دستورات پیکربندی (Configuration Commands)
- config list
- پیکربندی‌های موجود را فهرست می‌کند.
- config switch
- پیکربندی فعال را تغییر می‌دهد.
دستورات SDK (SDK Commands)
- sdk list
- کیت‌های توسعه (SDK) موجود را فهرست می‌کند.
- sdk install SDK_ID
- یک SDK مشخص را نصب می‌کند.
- sdk switch SDK_ID
- SDK فعال را برای پایپ‌لاین ساخت تغییر می‌دهد. در صورت امکان، این کار پیکربندی فعلی شما را برای استفاده از SDK به‌روزرسانی می‌کند.
- sdk shell SDK_ID
- وارد یک پوسته (shell) در محیط SDK می‌شود.
- sdk which PROGRAM
- محل قرارگیری برنامه را نشان می‌دهد.SS "دستورات وابستگی‌ها (Dependencies Commands)"
- dependencies list
- فهرست کردن وابستگی‌های پروژه.
- dependencies update
- به‌روزرسانی وابستگی‌های پروژه. این دستور وابستگی‌ها را کامپایل و ساخت (build) نمی‌کند. برای ساخت وابستگی‌ها از foundry build استفاده کنید.
دستورات دستگاه (Device Commands)
- device list
- فهرست کردن دستگاه‌های در دسترس.
- device switch
- تغییر دستگاه هدف فعلی.
دستورات استقرار (Deployment Commands)
- deploy
- استقرار پروژه روی دستگاه فعال.
دستورات آزمون (Test Commands)
- test list
- فهرست کردن آزمون‌های واحد (unit tests) در دسترس.
- test run TEST_ID
- اجرای یک آزمون واحد.
دستورات جست‌وجو (Search Commands)
دستورات تنظیمات (Settings Commands)
- settings get SCHEMA KEY
- دریافت مقدار یک تنظیم با اعمال اولویت تنظیمات به ترتیب از بازنویسی‌های کاربر (user overrides)، تنظیمات پروژه، و تنظیمات سراسری برنامه.
- settings set SCHEMA KEY VALUE
- تنظیم مقدار یک پیکربندی. از --global برای تعیین تنظیم به عنوان پیش‌فرض کاربر استفاده کنید. از --project برای تعیین تنظیم به عنوان پیش‌فرض پروژه (شامل سایر کاربرانی که پروژه را کلون می‌کنند) استفاده کنید. در غیر این صورت، این تنظیم تنها برای کاربر فعلی و در پروژه فعلی اعمال می‌شود.
دستورات اطلاعات محرمانه (Secret Commands)
- secret get-api-keyHOSTNAMESERVICE
- دریافت یک کلید API از مخزن داده‌های محرمانه (secret store). برای مثال: foundry secret get-api-key gitlab.gnome.org gitlab
- secret check-expires-atHOSTNAMESERVICE
- بررسی زمان انقضای کلید API برای یک سرویس در یک نام میزبان (hostname) مشخص. تاریخ انقضا در منطقه زمانی محلی نمایش داده خواهد شد.
- secret rotateHOSTNAMESERVICE
- چرخش و نوسازی (rotate) کلید API برای یک سرویس در یک نام میزبان مشخص. کلید API با استفاده از یک افزونه ثبت‌شده برای چرخش کلید تغییر یافته و کلید جدید به‌صورت امن ذخیره خواهد شد.
- secret set-api-keyHOSTNAMESERVICEAPI_KEY
- ذخیره یک کلید API در مخزن داده‌های محرمانه (secret store)..SS "دستورهای عیب‌یابی (Diagnosis Commands)"
- diagnose FILE
- تشخیص و عیب‌یابی مشکلات در FILE
دستورهای شرطی (CONDITIONAL COMMANDS)
دستورهای زیر تنها هنگامی در دسترس هستند که ویژگی‌های خاصی در زمان ساخت فعال شده باشند:
دستورهای Git (نیازمند feature-git)
- clone
- کلون کردن یک مخزن در یک دایرکتوری پروژهٔ جدید.
دستورهای مستندات (نیازمند feature-docs)
- doc bundle install
- نصب یک بستهٔ مستندات خاص.
- doc bundle list
- فهرست کردن بسته‌های مستندات موجود.
- doc query KEYWORD
- جستجو در مستندات.
دستورهای Forge (نیازمند feature-forge)
- forge list
- فهرست کردن یکپارچه‌سازی‌های forge موجود.
- forge issues list
- فهرست کردن issueها از forge.
- forge merge-requests list
- فهرست کردن درخواست‌های ادغام (merge requests) از forge.
- forge project
- نمایش اطلاعات دربارهٔ پروژهٔ forge.
- forge switch FORGE_ID
- forge switch --clear
- تعویض یکپارچه‌سازی فعال forge. از --clear برای پاک‌سازی تنظیمات forge به‌جای تنظیم کردن آن استفاده کنید.
- forge user
- نمایش اطلاعات دربارهٔ کاربر forge.
دستورهای ویرایش متن (نیازمند feature-text)
- grep
- جستجوی الگوهای متنی در فایل‌های منبع.
دستورهای LLM (نیازمند feature-llm)
- llm list-models
- فهرست کردن مدل‌های زبانی موجود.
- llm list-resources
- فهرست کردن منابع موجود.
- llm list-tools
- فهرست کردن ابزارهای LLM موجود.
- llm complete
- تکمیل متن با استفاده از یک مدل زبانی..SS دستورهای MCP (نیازمند feature-mcp)
- mcp
- اجرای سرور MCP. این سرور از طریق stdin/stdout و با استفاده از Model Context Protocol ارتباط برقرار می‌کند.
دستورهای LSP (نیازمند feature-lsp)
- lsp list
- فهرست کردن افزونه‌های سرور زبان (LSP) موجود.
- lsp prefer
- تنظیم LSP ترجیحی برای یک زبان.
- lsp run
- اجرای یک سرور زبان برای زبانی مشخص.
دستورهای الگو (نیازمند feature-templates)
- template create
- ایجاد یک پروژه جدید از روی یک الگو.
- template list
- فهرست کردن الگوهای پروژه موجود.
دستورهای کنترل نسخه (نیازمند feature-vcs)
- vcs blame
- نمایش اطلاعات blame برای فایل‌ها.
- vcs fetch
- دریافت تغییرات از مخازن دوردست (remote).
- vcs ignored
- فهرست کردن فایل‌های نادیده‌گرفته‌شده.
- vcs list
- فهرست کردن اطلاعات کنترل نسخه.
- vcs list-branches
- فهرست کردن شاخه‌های موجود در مخزن.
- vcs list-files
- فهرست کردن فایل‌های ردیابی‌شده توسط کنترل نسخه.
- vcs list-remotes
- فهرست کردن مخازن دوردست.
- vcs list-tags
- فهرست کردن برچسب‌ها (تگ‌ها) در مخزن.
- vcs log FILE
- نمایش تاریخچه ثبت تغییرات (commit) برای FILE.
- vcs switch
- تغییر شاخه‌ها یا checkoutها.
گزینه‌ها (OPTIONS)
- استفاده از حالت اشتراکی برای دستور.
- -h, --help
- نمایش
اطلاعات
راهنما
برای
دستور..SH
"مثال‌ها
(EXAMPLES)"
راه‌اندازی یک پروژه جدید:
foundry init
ساخت پروژه:
foundry build
اجرای یک دستور پروژه:
foundry run
ورود به محیط ساخت:
foundry devenv
فهرست کردن SDKهای موجود:
foundry sdk list
نصب یک SDK:
foundry sdk install
org.gnome.Sdk/x86_64/master
راه‌اندازی یک سرور زبان:
foundry lsp run python3
ویژگی‌ها (FEATURES)
ممکن است Foundry با غیرفعال یا حذف شدن ویژگی‌های گوناگونی کامپایل شده باشد. اگر ویژگی زیربنایی مربوطه در نسخهٔ Foundry شما کامپایل نشده باشد، ممکن است برخی از دستورها در دسترس نباشند.
همچنین ببینید (SEE ALSO)
برای اطلاعات بیشتر، وب‌سایت زیر را ببینید: https://devsuite.app
گزارش باگ‌ها (BUGS)
گزارش‌های اشکال را می‌توانید در نشانی زیر یافته یا ثبت کنید: https://gitlab.gnome.org/chergert/foundry/issues
| November 2025 |