نام (NAME)

usdchecker - ابزار بررسی انطباق استیج‌های USD یا بسته‌های USDZ

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

usdchecker [OPTIONS] [inputFile]

توضیحات (DESCRIPTION)

ابزاری برای بررسی میزان انطباق و صحت یک استیج USD یا یک بستهٔ USDZ مشخص. در حال حاضر، تنها نخستین نمونه از هر صفت مرتبط وابسته به زمان (time-sampled) بررسی می‌شود.

آرگومان‌های موضعی (Positionals):

inputFile FILE: نام فایل ورودی جهت بازرسی و بررسی.

گزینه‌ها (OPTIONS)

-h,--help: نمایش این پیام راهنما و خروج.
--includeKeywords KEYWORDS: در صورت تعیین، تنها اعتبارسنج‌های مربوط به کلیدواژه‌های ارائه‌شده اجرا می‌شوند. می‌توان چندین کلیدواژه را با کاما جدا کرد. در صورت عدم تعیین، تمامی اعتبارسنج‌ها اجرا خواهند شد.
-s,--skipVariants: در صورت تعیین، تنها primهایی که در گونه‌های (variants) پیش‌فرض (انتخاب‌شده) حضور دارند بررسی می‌شوند. وقتی این گزینه مشخص نشود، primها در تمام ترکیب‌های ممکن از انتخاب‌های گونه بررسی خواهند شد.
-p,--rootPackageOnly: تنها بستهٔ مشخص‌شده را بررسی می‌کند. بسته‌های تو‌در‌تو، وابستگی‌ها و محتویات آن‌ها اعتبارسنجی نمی‌شوند.
-o,--out FILE: فایلی که تمامی بررسی‌های ناموفق در آن خروجی داده می‌شوند. در صورت عدم تعیین، بررسی‌های ناموفق در stdout نوشته می‌شوند؛ اگر «stderr» تعیین شود، رنگ‌بندی ترمینال غیرفعال خواهد شد.
--noAssetChecks: در صورت تعیین، بررسی‌های اضافی جهت اطمینان از این‌که استیج یا بسته می‌تواند به‌راحتی و با اطمینان در استیج‌های تجمیعی ارجاع داده شود را انجام نمی‌دهد.
-d,--dumpRules: نمایش فهرست قوانین شمرده‌شده که بر اساس گزینه‌های داده‌شده در حال بررسی هستند.
-v,--verbose: فعال‌سازی حالت خروجی پرگو (با جزئیات کامل).
-t,--strict: جهت انطباق سخت‌گیرانه‌تر، حتی در صورت صدور هشدار نیز کد وضعیت خروج ناموفق بازمی‌گرداند.
--variantSets TEXT ...: فهرستی از variantSetها جهت اعتبارسنجی. تمامی گونه‌ها برای variantSetهای داده‌شده اعتبارسنجی می‌شوند. همچنین می‌تواند همراه با --variants برای اعتبارسنجی گونه‌های داده‌شده در ترکیب با گونه‌های حاصل از variantSetهای صریحاً مشخص‌شده به کار رود. این گزینه تنها هنگام استفاده از چارچوب اعتبارسنجی جدید معتبر است.
--variants TEXT ...: فهرستی از جفت‌های variantSet:variant جداشده با «,» جهت اعتبارسنجی. هر مجموعه از گونه‌ها در فهرست به‌طور جداگانه اعتبارسنجی می‌شود. مثال: --variants foo:bar,baz:qux موارد foo:bar و baz:qux را با یکدیگر اعتبارسنجی می‌کند، اما --variants foo:bar --variants baz:qux هر یک از foo:bar و baz:qux را به‌طور جداگانه بررسی خواهد کرد. این گزینه همچنین می‌تواند همراه با --variantSets برای اعتبارسنجی گونه‌های مشخص‌شده در ترکیب با گونه‌های مربوط به variantSetهای صریحاً ذکرشده به کار رود. این گزینه تنها هنگام استفاده از چارچوب اعتبارسنجی جدید معتبر است.
--disableVariantValidationLimit: غیرفعال‌سازی سقف تعیین‌شده برای محدود کردن تعداد فراخوانی‌های اعتبارسنجی گونه‌ها. این گزینه زمانی مفید است که تعداد گونه‌ها زیاد باشد و بخواهیم تمام ترکیب‌های ممکن از گونه‌ها را اعتبارسنجی کنیم. مقدار پیش‌فرض، محدود کردن تعداد فراخوانی‌های اعتبارسنجی به ۱۰۰۰ است. این گزینه تنها هنگام استفاده از چارچوب اعتبارسنجی جدید معتبر است.