مرجع Lightbuild CLI

‫Lightbuild CLI هي أداة سطر الأوامر الرسمية لـ Lightbuild. تصف هذه الصفحة أوامرها وخياراتها. لتثبيت Lightbuild CLI، يُرجى الاطّلاع على تثبيت Lightbuild CLI. للمهام الشائعة، مثل إنشاء مشروعك واختباره، يُرجى الاطّلاع على إنشاء مشاريع Lightbuild من سطر الأوامر.

البنية

تستخدم واجهة سطر أوامر Lightbuild الصيغة التالية:

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

وتتوفّر الخيارات العامة التالية:

Option الوصف
-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