مرجع Lightbuild CLI

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

نحو

Lightbuild CLI از نحو زیر استفاده می‌کند:

lightbuild [-V] [--project=path] [COMMAND]

از گزینه‌های جهانی زیر پشتیبانی می‌کند:

گزینه شرح
-V، --version اطلاعات نسخه را چاپ می‌کند و خارج می‌شود.
-p، --project=path مسیر مطلق به پروژه شما. به‌طور پیش‌فرض روی دایرکتوری کنونی تنظیم شده است که باید حاوی پروژه باشد.

برای فهرست کردن فرمان‌های دردسترس، lightbuild help را اجرا کنید. برای دریافت راهنمایی برای فرمانی خاص، lightbuild help [command] را اجرا کنید.

lightbuild build

هدفی در پروژه‌تان می‌سازد.

lightbuild build [target]
متغیر مستقل شرح
target هدف برای ساخت. به‌طور پیش‌فرض همه هدف‌های زیر دایرکتوری فعلی را انتخاب می‌کند.

برای مثال، برای ساختن واحد app، این کد را اجرا کنید:

lightbuild build app

برای ساختن همه هدف‌ها در پروژه‌تان، این دستور را اجرا کنید:

lightbuild build

lightbuild clean

خروجی ساخت و حافظه‌های پنهان پروژه شما را برمی‌دارد.

lightbuild clean [target]
متغیر مستقل شرح
target هدف برای پاک‌سازی. به‌طور پیش‌فرض همه هدف‌های زیر دایرکتوری فعلی را انتخاب می‌کند.

برای مثال، برای برداشتن خروجی ساخت و حافظه‌های پنهان برای کل پروژه، این دستور را اجرا کنید:

lightbuild clean

lightbuild help

فرمان‌های دردسترس را فهرست می‌کند یا راهنمای فرمان خاصی را نشان می‌دهد.

lightbuild help [COMMAND]
متغیر مستقل شرح
COMMAND فرمانی که راهنمای آن نشان داده می‌شود. به‌طور پیش‌فرض روی همه فرمان‌ها تنظیم شده است.

برای فهرست کردن فرمان‌های دردسترس برای پروژه‌تان، این دستور را اجرا کنید:

lightbuild help

برای نشان دادن راهنمای فرمان خاصی، مثل query، این دستور را اجرا کنید:

lightbuild help query

lightbuild query

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

lightbuild query [target-pattern] [--format=format] [--output=type]
گزینه یا متغیر مستقل شرح
target-pattern الگوی مسیر هدف، برای مثال ... یا app.
--format=format قالب خروجی، برای مثال json. به‌طور پیش‌فرض جدول است.
--output=type قالب برونداد: files برای مکان فایل‌هایی که هدف‌های منطبق تولید می‌کنند، sourcesets برای مجموعه‌های منبع آن‌ها، یا sourceset_types برای انواع مجموعه‌های منبع آن‌ها.

برای فهرست کردن همه هدف‌ها در پروژه‌تان، این فرمان را اجرا کنید:

lightbuild query ...

برای چاپ مکان فایل‌هایی که هدف app تولید می‌کند، این دستور را اجرا کنید:

lightbuild query app --output=files

lightbuild resolve

وابستگی‌های خارجی پروژه‌تان را حل می‌کند و فایل‌های قفل وابستگی آفلاین (resolved.deps) را برای واحدهای آن تولید می‌کند.

lightbuild resolve [--cache=path] [--locked-dependencies] [target]
گزینه یا متغیر مستقل شرح
target پیمانه‌ای که وابستگی‌ها برای آن حل‌وفصل می‌شود، برای مثال app. به‌طور پیش‌فرض همه هدف‌های زیر دایرکتوری فعلی را انتخاب می‌کند.
--locked-dependencies اگر فایل قفل وابستگی محلی (resolved.deps) همگام‌سازی نشده باشد، با خطا خارج می‌شود.
--cache=path دایرکتوری‌ای که حافظه پنهان وابستگی در آن ذخیره می‌شود.

برای مثال، برای تولید فایل‌های resolved.deps برای همه ماژول‌ها در پروژه‌تان، این دستور را اجرا کنید:

lightbuild resolve

برای اطلاعات بیشتر درباره فایل‌های resolved.deps، وابستگی‌های حل‌شده را ببینید.

lightbuild test

آزمایش‌ها را در پروژه‌تان اجرا می‌کند: آزمایش‌های محلی که در ماشین توسعه نرم‌افزار شما اجرا می‌شوند، و آزمایش‌های ابزاری که در دستگاه متصل‌شده یا شبیه‌ساز درحال اجرا اجرا می‌شوند. برای آزمایش یک واحد، هدف آن را مشخص کنید، مثلاً app-core. برای اجرای فقط یک نوع آزمایش، :hostTest را برای آزمایش‌های محلی یا :deviceTest را برای آزمایش‌های ابزاردار به هدف اضافه کنید.

lightbuild test [target] [--locked-dependencies]
گزینه یا متغیر مستقل شرح
target هدف برای آزمایش. به‌طور پیش‌فرض همه آزمایش‌های پروژه‌تان را شامل می‌شود.
--locked-dependencies اگر فایل قفل وابستگی محلی (resolved.deps) همگام‌سازی نشده باشد، ساخت ناموفق خواهد بود.

برای مثال، برای اجرای همه آزمایش‌ها در پروژه‌تان، این دستور را اجرا کنید:

lightbuild test

برای اجرای آزمایش‌های محلی در واحد app-core، این دستور را اجرا کنید:

lightbuild test app-core:hostTest

برای اجرای آزمایش‌های ابزاردار در واحد app-core در دستگاه یا شبیه‌ساز، این دستور را اجرا کنید:

lightbuild test app-core:deviceTest