פיתוח פרויקטים של Lightbuild משורת הפקודה

‫Lightbuild CLI הוא כלי שורת הפקודה הרשמי של Lightbuild. משתמשים בפקודה lightbuild כדי לבנות ולבדוק את הפרויקט, למצוא את יעדי ה-build שלו ולפתור את יחסי התלות שלו. סוכני ה-AI יכולים להריץ את אותן פקודות. פרויקטים שיוצרים מתבנית Lightbuild כוללים קובץ AGENTS.md שמנחה את סוכני ה-AI איך לעבוד עם Lightbuild ועם Lightbuild CLI.

מידע נוסף על הפקודות והאפשרויות של Lightbuild CLI זמין במדריך העזר של Lightbuild CLI.

התקנת ה-CLI של Lightbuild

‫Lightbuild CLI מופץ כחבילת Android SDK שמתקינים באמצעות Android CLI. אפשר להתקין ולהגדיר אותו באמצעות פקודה אחת, או להתקין אותו ידנית.

התקנה והגדרה בשלב אחד

כדי להתקין את ה-CLI של Lightbuild, מריצים את הפקודה שמתאימה למערכת ההפעלה. הפקודה מתקינה את חבילת ה-CLI של Lightbuild ב-Android SDK, ואז מריצה את סקריפט ההגדרות של החבילה, שמעתיק את ה-CLI של Lightbuild אל ~/.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"

אחרי שהפקודה מסתיימת, מאמתים את ההתקנה.

הטמעה ידנית

כדי להתקין את ה-CLI של Lightbuild ולהוסיף אותו ל-PATH בעצמכם:

  1. אם Android CLI לא מותקן, מתקינים אותו.

  2. מתקינים את חבילת Lightbuild:

    android sdk install build/lightbuild/0.0.30

  3. מעתיקים את ה-CLI של Lightbuild לספרייה ב-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. אימות ההתקנה

אימות ההתקנה

כדי לוודא שה-CLI של Lightbuild מותקן, בודקים את הגרסה שלו:

lightbuild --version

אם הטרמינל לא מוצא את הפקודה lightbuild, פותחים חלון טרמינל חדש כדי שהשינויים ב-PATH ייכנסו לתוקף.

איך מוצאים את יעדי ה-build של הפרויקט

פקודות ה-CLI של 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

כדי להסיר את פלט ה-build והמטמון של הפרויקט, מריצים את הפקודה:

lightbuild clean

מפעילים את האפליקציה

ה-CLI של 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

מידע נוסף זמין במאמר יחסי תלות שנפתרו.