ساختن پروژه‌های Lightbuild از خط فرمان

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

برای اطلاعات بیشتر درباره فرمان‌ها و گزینه‌های Lightbuild CLI، به مرجع Lightbuild CLI مراجعه کنید.

نصب Lightbuild CLI

Lightbuild CLI به‌عنوان بسته کیت توسعه نرم‌افزار Android توزیع می‌شود که آن را با Android CLI نصب می‌کنید. می‌توانید آن را با یک فرمان نصب و راه‌اندازی کنید، یا آن را به‌صورت دستی نصب کنید.

نصب و راه‌اندازی در یک مرحله

برای نصب Lightbuild CLI، فرمان مربوط به سیستم‌عامل خود را اجرا کنید. فرمان بسته Lightbuild CLI را در کیت توسعه نرم‌افزار 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" }; if ($LASTEXITCODE -eq 0) { $env:Path += ";$HOME\AppData\LightbuildCLI"; setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null }

  • 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" && setx LIGHTBUILD_REFRESH 1 >nul && reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f >nul

پس‌از اتمام دستور، نصب را درستی‌سنجی کنید.

نصب دستی

یا برای نصب Lightbuild CLI و افزودن آن به 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 = (Get-ItemProperty HKCU:\Environment).Path
if (($userPath -split ";") -notcontains $dir) { Set-ItemProperty HKCU:\Environment Path "$userPath;$dir" -Type ExpandString }
setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null
$env:Path += ";$dir"

  4. درستی‌سنجی نصب

درستی‌سنجی نصب

برای تأیید اینکه Lightbuild CLI نصب شده است، نسخه آن را بررسی کنید:

lightbuild --version

اگر ترمینال شما نمی‌تواند فرمان lightbuild را پیدا کند، پنجره ترمینال جدیدی باز کنید تا تغییرات PATH اعمال شود.

یافتن هدف‌های ساخت پروژه

فرمان‌های Lightbuild CLI هدفی را می‌گیرند که بخشی از پروژه شما را برای ساخت، آزمایش، یا بازرسی شناسایی می‌کند. هدف می‌تواند نام یک ماژول باشد، مانند 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

برای ساختن دسته برنامه نسخه پخش امضاشده‌ای که بتوانید در Google Play بارگذاری کنید، برنامه Lightbuild خود را منتشر کنید.

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

lightbuild clean

اجرای برنامه

‫Lightbuild CLI برنامه شما را می‌سازد، اما آن را نصب یا اجرا نمی‌کند. برای اجرای برنامه در دستگاه متصل‌شده یا شبیه‌ساز درحال اجرا، برنامه را بسازید، سپس آن را با فرمان 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

برای اطلاعات بیشتر، به وابستگی‌های حل‌شده مراجعه کنید.