نام (NAME)

appstream-generator - تولید فراداده AppStream از مخازن توزیع

خلاصه دستور (SYNOPSIS)

appstream-generator [COMMAND]

توضیحات (DESCRIPTION)

این صفحه راهنما به‌طور خلاصه دستور appstream-generator را شرح می‌دهد.

appstream-generator فراداده‌های AppStream را از مخازن یک توزیع نرم‌افزاری تولید می‌کند. این ابزار در حال حاضر از قالب‌های مخزن / توزیع‌های زیر پشتیبانی می‌کند: Debian، Ubuntu، Arch Linux، RPM-MD (Fedora، Mageia).

تولیدکننده، فایل‌های فراداده کاتالوگ AppStream را در قالب AppStream YAML یا XML به منظور ارائه به کاربران تولید می‌کند، و همچنین گزارش‌های تفصیلی HTML درباره مؤلفه‌های یافت‌شده و گزارش‌های HTML و JSON از مشکلات مشاهده‌شده در حین تدوین فراداده‌ها ارائه می‌دهد. این ابزار فایل‌های .desktop و همچنین فایل‌های metainfo را می‌خواند، فونت‌ها را رندر می‌کند، تصاویر را تغییر اندازه می‌دهد، نماگرفت‌ها (screenshots) را کش می‌کند و کارهای دیگر را برای تولید فراداده‌های باکیفیت جهت استفاده مراکز نرم‌افزاری مبتنی بر AppStream و سایر ابزارها انجام می‌دهد. معمولاً appstream-generator با گردش کار موجود برای ساخت و تحویل نرم‌افزار در یک توزیع ادغام می‌شود.

ابزار appstream-generator بر پایه کتابخانه libappstream برای تبدیل و تحلیل فراداده است. اگر صرفاً می‌خواهید پردازش فراداده AppStream را در ابزار دیگری تعبیه کنید، استفاده مستقیم از libappstream احتمالاً انتخاب بهتری است. ابزار تولیدکننده کارهای سنگینی مانند رندر قلم‌ها و مقیاس‌بندی تصاویر انجام می‌دهد که ممکن است برای موارد ساده ضروری نباشد.

برای استفاده از appstream-generator، یک فایل پیکربندی لازم است. قالب‌های JSON و YAML پشتیبانی می‌شوند (برای مثال asgen-config.json یا asgen-config.yaml). قالب آن به تفصیل در مستندات asgen-config[1] شرح داده شده است.

این تولیدکننده از طیف گسترده‌ای از ویژگی‌ها پشتیبانی می‌کند که می‌توان آن‌ها را به‌صورت جداگانه پیکربندی کرد تا با نیازهای پروژه‌های مختلف سازگار شده و فراداده‌های تولیدشده با موارد کاربرد خاص تنظیم شوند. برای کسب اطلاعات درباره گزینه‌های موجود، به مستندات فایل پیکربندی مراجعه کنید.

برای کسب اطلاعات بیشتر درباره پروژه AppStream و سایر مؤلفه‌هایی که بخشی از آن هستند، صفحات AppStream را در Freedesktop.org[2] مشاهده کنید.

گزینه‌ها (OPTIONS)

run SUITE [SECTION]

پردازش فراداده‌های جدید برای مجموعه (suite) توزیع داده‌شده و انتشار آن.

cleanup

پاک‌سازی فراداده‌ها و فایل‌های چندرسانه‌ای قدیمی/منقضی‌شده از حافظه موقت (cache) و پوشه‌ها. توصیه می‌شود این دستور بسته به میزان تغییرات در مخزن نرم‌افزاری، هر هفته یا دست‌کم هر ماه اجرا شود.

publish SUITE [SECTION]

برون‌ریزی تمام فراداده‌ها و انتشار گزارش‌ها در پوشه‌های خروجی (export).

معمولاً نمی‌خواهید این وظیفه را به‌طور صریح اجرا کنید، زیرا از قبل به‌طور خودکار توسط دستور run انجام می‌شود.

remove-found SUITE

حذف تمام فراداده‌های پردازش‌شده معتبر و نکات راهنما (hints) از مجموعه انتخاب‌شده.

forget PKID

حذف تمام اطلاعات موجود درباره این شناسه بسته (package-id) (کامل یا جزئی).

یک شناسه بسته از سه‌گانه name/version/arch تشکیل شده است. برای این دستور، می‌توان نسخه و معماری را حذف کرد تا تمام بسته‌های منطبق با یک نام خاص یا ترکیب نام-نسخه فراموش شوند.

info PKID

نمایش اطلاعات مرتبط با این شناسه بسته (package-id) (کامل).

یک شناسه بسته از سه‌گانه name/version/arch تشکیل شده است.

-w|--workspace DIR

تعیین مکان فضای کاری (workspace).

اگر این پرچم حذف شود و هیچ پوشه فضای کاری در فایل پیکربندی تولیدکننده مشخص نشده باشد، پوشه جاری به عنوان مکان فضای کاری در نظر گرفته می‌شود.

این پارامتر، در صورت مشخص شدن، بر هر مکان فضای کاری تعریف‌شده در جاهای دیگر اولویت دارد.

-c|--config FILE

تعیین یک فایل پیکربندی.

تعیین صریح یک فایل پیکربندی برای تولیدکننده (JSON یا YAML). اگر این پرچم حذف شود، تولیدکننده در پوشه فضای کاری جاری به دنبال asgen-config.json، سپس asgen-config.yaml و سپس asgen-config.yml می‌گردد.

اگر هیچ پوشه فضای کاری درون خود فایل پیکربندی تعریف نشده باشد، پوشه‌ای که فایل در آن قرار دارد به عنوان فضای کاری استفاده می‌شود. این حالت را می‌توان با تعیین صریح یک فضای کاری با -w لغو کرد.

--force

اجرای اجباری دستور.

--verbose

نمایش اطلاعات اشکال‌زدایی اضافی.

--version

نمایش شماره نسخه appstream-generator.