glib-compile-schemas(1) General Commands Manual glib-compile-schemas(1)

glib-compile-schemas - کامپایل فایلهای شمای GSettings به فرمت باینری

glib-compile-schemas [OPTION…] DIRECTORY

دستور glib-compile-schemas تمامی پرونده‌های شمای XML مربوط به GSettings را در DIRECTORY به یک پرونده باینری با نام gschemas.compiled کامپایل می‌کند که می‌تواند توسط GSettings استفاده شود. پرونده‌های شمای XML باید دارای پسوند .gschema.xml باشند. برای توضیحات دقیق درباره قالب پرونده XML، به مستندات GSettings مراجعه کنید.

در زمان اجرا، GSettings شِماها را در زیردایرکتوری‌های glib-2.0/schemas از تمامی دایرکتوری‌های مشخص‌شده در متغیرهای محیطی XDG_DATA_DIRS و XDG_DATA_HOME جستجو می‌کند. مکان معمول برای نصب پرونده‌های شِما، مسیر /usr/share/glib-2.0/schemas است.

علاوه بر پرونده‌های شِما، دستور glib-compile-schemas پرونده‌های «vendor override» (بازنویسی سازنده) را نیز می‌خواند؛ این‌ها پرونده‌های کلیدی هستند که می‌توانند مقادیر پیش‌فرض کلیدها را در شِماها بازنویسی کنند. نام گروه‌ها در پرونده‌های کلید، همان شناسه شِما (schema ID) است و مقادیر به صورت فرم سریال‌شده GVariant نوشته می‌شوند. پرونده‌های vendor override باید دارای پسوند .gschema.override باشند.

طبق قرارداد، پرونده‌های vendor override با nn_ شروع می‌شوند که در آن nn عددی بین 00 تا 99 است. پرونده‌هایی با شماره بالاتر اولویت بیشتری دارند (برای مثال اگر بازنویسی یکسانی در یک پرونده با شماره 10 و سپس مجدداً در پرونده‌ای با شماره 20 انجام شود، بازنویسی شماره 20 اولویت خواهد داشت).

-h, --help

چاپ راهنما و خروج.

--version

چاپ نسخه برنامه و خروج.

--targetdir <TARGET>

ذخیره gschemas.compiled در دایرکتوری TARGET به جای DIRECTORY.

--strict

توقف و لغو عملیات در صورت وجود هرگونه خطا در شِماها. بدون این گزینه، پرونده‌های شِمای دارای اشکال به سادگی از شِمای کامپایل‌شده نهایی حذف می‌شوند.

--dry-run

عدم نوشتن gschemas.compiled. از این گزینه می‌توان برای بررسی خطاهای منابع .gschema.xml استفاده کرد.

--allow-any-name

عدم اعمال محدودیت روی نام‌های کلید. توجه داشته باشید که این گزینه صرفاً برای تسهیل انتقال از GConf است و در آینده حذف خواهد شد.

gsettings(1), dconf(1)