إنشاء مشاريع Lightbuild من سطر الأوامر

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

لمزيد من المعلومات حول أوامر وخيارات واجهة سطر أوامر Lightbuild، يُرجى الاطّلاع على مرجع واجهة سطر أوامر Lightbuild.

تثبيت Lightbuild CLI

يتم توزيع Lightbuild CLI كحزمة SDK لنظام التشغيل Android يتم تثبيتها باستخدام Android CLI. يمكنك تثبيته وإعداده باستخدام أمر واحد، أو تثبيته يدويًا.

التثبيت والإعداد في خطوة واحدة

لتثبيت واجهة سطر أوامر Lightbuild، شغِّل الأمر المناسب لنظام التشغيل لديك. يثبّت الأمر حزمة Lightbuild CLI في حزمة تطوير البرامج (SDK) لنظام التشغيل Android، ثم يشغّل نص التهيئة البرمجي للحزمة، والذي ينسخ Lightbuild CLI إلى ~/.local/bin على نظامَي التشغيل macOS وLinux، أو إلى $HOME\AppData\LightbuildCLI على نظام التشغيل Windows، ويتأكّد من أنّ هذا الدليل في PATH:

  • نظاما التشغيل macOS وLinux:

    android sdk install build/lightbuild/0.0.30 && bash "$(android info sdk)/build/lightbuild/0.0.30/cli/install.sh"

  • ‫Windows (PowerShell):

    android sdk install build/lightbuild/0.0.30; if ($LASTEXITCODE -eq 0) { & "$(android info sdk)\build\lightbuild\0.0.30\cli\install.cmd" }

  • نظام التشغيل Windows (موجّه الأوامر):

    android sdk install build/lightbuild/0.0.30 && for /f "delims=" %p in ('android info sdk') do call "%p\build\lightbuild\0.0.30\cli\install.cmd"

بعد انتهاء الأمر، تحقَّق من التثبيت.

التثبيت يدويًا

لتثبيت واجهة سطر أوامر Lightbuild وإضافتها إلى PATH بنفسك، اتّبِع الخطوات التالية:

  1. إذا لم يكن لديك Android CLI، يمكنك تثبيته.

  2. ثبِّت حزمة Lightbuild:

    android sdk install build/lightbuild/0.0.30

  3. انسخ Lightbuild CLI إلى دليل في PATH لتتمكّن من تشغيل lightbuild من أي دليل. يمكنك نسخه إلى أي دليل موجود بالفعل في PATH، أو استخدام الدليل نفسه الذي يستخدمه نص التهيئة البرمجي:

    • نظاما التشغيل macOS وLinux: انسخ ملف lightbuild إلى ~/.local/bin:

      mkdir -p ~/.local/bin
cp "$(android info sdk)/build/lightbuild/0.0.30/cli/lightbuild" ~/.local/bin/

      إذا لم يكن ~/.local/bin في PATH، أضِف السطر التالي إلى ملف بدء تشغيل واجهة الأوامر، مثل ~/.zshrc أو ~/.bashrc:

      export PATH="$PATH:$HOME/.local/bin"

    • نظام التشغيل Windows: نفِّذ الأوامر التالية في PowerShell. يتم نسخ lightbuild.exe إلى $HOME\AppData\LightbuildCLI، وإضافة هذا الدليل إلى Path المستخدم إذا لم يكن موجودًا:

      $dir = "$HOME\AppData\LightbuildCLI"
New-Item -ItemType Directory -Force $dir | Out-Null
Copy-Item "$(android info sdk)\build\lightbuild\0.0.30\cli\lightbuild.exe" $dir
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if (($userPath -split ";") -notcontains $dir) { [Environment]::SetEnvironmentVariable("Path", "$userPath;$dir", "User") }

  4. التحقّق من التثبيت

التحقّق من التثبيت

للتحقّق من تثبيت Lightbuild CLI، اطّلِع على إصداره:

lightbuild --version

إذا لم تتمكّن المحطة الطرفية من العثور على الأمر lightbuild، افتح نافذة محطة طرفية جديدة لتطبيق تغييرات PATH.

العثور على أهداف الإصدار لمشروعك

تتلقّى أوامر واجهة سطر الأوامر في Lightbuild هدفًا يحدّد جزء المشروع الذي سيتم إنشاؤه أو اختباره أو فحصه. يمكن أن يكون الهدف اسم وحدة، مثل app، أو شيء أكثر تحديدًا، مثل app:app-debug.apk. لمطابقة جميع الأهداف في وحدة معيّنة، استخدِم اسم الوحدة متبوعًا بـ /...، مثل app/.... لمطابقة جميع الأهداف في مشروعك، استخدِم ....

لإدراج جميع الأهداف في مشروعك، يمكنك الاستعلام عنها من الدليل الجذري لمشروعك:

lightbuild query ...

لإدراج الملفات التي ينتجها هدف معيّن، أضِف --output=files. على سبيل المثال، بالنسبة إلى الهدف app، شغِّل:

lightbuild query app --output=files

للاطّلاع على قائمة بالأوامر المتاحة لمشروعك، نفِّذ الأمر lightbuild help.

إنشاء تطبيقك

لإنشاء هدف، شغِّل lightbuild build مع الهدف. على سبيل المثال، لإنشاء وحدة app، شغِّل:

lightbuild build app

لإنشاء جميع الأهداف في مشروعك، نفِّذ ما يلي:

lightbuild build

لإزالة ناتج الإصدار وذاكرة التخزين المؤقت لمشروعك، نفِّذ ما يلي:

lightbuild clean

تشغيل تطبيقك

تُنشئ واجهة سطر أوامر Lightbuild تطبيقك، ولكنّها لا تثبّته أو تشغّله. لتشغيل تطبيقك على جهاز متصل أو محاكي قيد التشغيل، عليك إنشاء التطبيق ثم تشغيله باستخدام الأمر android run في Android CLI:

lightbuild build app
android run --apks=app/build/app-debug.apk

لمعرفة مكان كتابة كل هدف من أهداف الوحدة لمخرجاته، شغِّل lightbuild query app/... --output=files. تكون المواقع الجغرافية مرتبطة بدليل الوحدة.

إجراء الاختبارات

لتشغيل جميع الاختبارات في مشروعك، شغِّل:

lightbuild test

يؤدي هذا الأمر إلى تشغيل الاختبارات المحلية التي يتم إجراؤها على جهاز التطوير، والاختبارات لقياس حالة التطبيق التي يتم إجراؤها على جهاز متصل أو محاكي قيد التشغيل.

لتشغيل الاختبارات في وحدة واحدة، أضِف هدف الوحدة، مثل app-core. لتشغيل نوع واحد فقط من الاختبارات، أضِف :hostTest للاختبارات المحلية أو :deviceTest لاختبارات لقياس حالة التطبيق إلى هدف الوحدة. على سبيل المثال:

lightbuild test app-core:hostTest
lightbuild test app-core:deviceTest

حلّ التبعيات

تسجّل كل وحدة تبعياتها التي تم حلّها في ملف resolved.deps. لإنشاء ملف resolved.deps لوحدة معيّنة، شغِّل lightbuild resolve مع هدف الوحدة. على سبيل المثال، بالنسبة إلى الوحدة app، شغِّل:

lightbuild resolve app

لحلّ جميع الأهداف في مشروعك، نفِّذ ما يلي:

lightbuild resolve

لمزيد من المعلومات، يُرجى الاطّلاع على الاعتماديات التي تم حلّها.