Lightbuild یک تجربه ساخت اعلانی برای پروژه‌های Android است که پیکربندی ساخت را برای شما و عواملتان آسان‌تر می‌کند تا بتوانید آن را بخوانید و ویرایش کنید. پروژه‌تان را در فایل‌های YAML شرح می‌دهید و سپس آن را با Android Studio Canary یا Lightbuild CLI می‌سازید.
نحوه عملکرد Lightbuild
وقتی پروژه جدیدی ایجاد می‌کنید، معمولاً از زبان پیکربندی ساخت Kotlin DSL استفاده می‌کنید که به‌طور رسمی توسط Android پشتیبانی و توصیه می‌شود. Lightbuild جایگزینی آزمایشی است که رویکرد متفاوتی دارد.
فایل‌های پیکربندی Lightbuild اعلانی هستند: به‌جای نوشتن منطق ساخت اجرایی، آنچه را که پروژه‌تان شامل می‌شود و نحوه ساخت آن را اعلام می‌کنید. پروژه Lightbuild از فایل‌های زیر استفاده می‌کند:
project.lightbuild.yaml: فایلی در دایرکتوری ریشه پروژه شما که تنظیمات سراسری پروژه را تعریف می‌کند، مانند ماژول‌های پروژه، مخازنی که وابستگی‌ها از آن‌ها دریافت می‌شود، و نسخه Lightbuild.lightbuild.yaml: فایلی در هر واحد که نوع واحد، تنظیمات Android، وابستگی‌ها، و آزمایش‌ها را تعریف می‌کند.resolved.deps: فایلی که به‌طور خودکار در هر واحد تحت مدیریت Lightbuild تولید می‌شود و وابستگی‌های حل‌شده را ثبت می‌کند تا نیازی به حل مجدد آن‌ها در هنگام باز کردن یا ساختن نباشد. به‌طور دستی ویرایش نکنید.
برای اطلاعات بیشتر، به ساختار پروژه Lightbuild و مرجع پیکربندی Lightbuild مراجعه کنید.
مزايا
Lightbuild بااستفاده از فایل‌های پیکربندی اعلانی مبتنی بر YAML، چندین مزیت برای گردش‌های کاری عامل‌محور و کاربران Android Studio Canary ارائه می‌دهد:
- پیکربندی سازگار با عامل: فایل‌های پیکربندی ساخت مبتنی بر YAML در Lightbuild و میانای خط فرمان قدرتمند آن به‌گونه‌ای طراحی شده‌اند که به عوامل هوش مصنوعی اجازه دهند پیکربندی ساخت شما را به‌طور کارآمدتری تجزیه کنند، چیدمان و خروجی‌های پروژه شما را درک کنند، وابستگی‌ها را به‌روز کنند، و واحدها را ویرایش کنند، همه این‌ها تحت کنترل شما انجام می‌شود.
- ساخته‌شده در «استودیو Android»: پروژه‌های Lightbuild به‌طور کامل در «استودیو Android» نسخه Canary پشتیبانی می‌شوند. معماری اعلانی Lightbuild باز شدن پروژه‌ها را تسریع می‌کند و نیاز به همگام‌سازی دستی پس‌از تغییرات پیکربندی را ازبین می‌برد و شما را در جریان کار نگه می‌دارد.
- گردش‌های کاری خط فرمان: پروژه‌های Lightbuild را از ترمینال خود با Lightbuild CLI بسازید، آزمایش کنید، و بازرسی کنید، یا از عامل‌های هوش مصنوعی بخواهید این کار را برای شما انجام دهند. علاوه‌براین، پروژه‌های Lightbuild کاملاً با Android CLI و مجموعه قدرتمند ویژگی‌های توسعه مفید آن سازگار هستند.
- وابستگی‌های ازپیش حل‌شده: Lightbuild وابستگی‌های شما را به‌طور پیش‌کنشی حل می‌کند و آن‌ها را در فایل
resolved.depsبرای هر ماژول ثبت می‌کند. با بررسی این فایل‌ها در کنترل نسخه، پروژه شما به‌طور کامل از وضوح پویا عبور می‌کند و به آن اجازه می‌دهد سریع‌تر باز و ساخته شود.
روش‌های استفاده از Lightbuild
می‌توانید از Lightbuild با Android Studio Canary، Lightbuild CLI، و Android CLI به‌صورت جداگانه یا باهم استفاده کنید. جدول زیر ابزاری را برای کارهای رایج توصیه می‌کند:
| کاری که می‌خواهید انجام دهید | ابزار توصیه‌شده |
|---|---|
| ایجاد پروژه Lightbuild | Android Studio Canary یا Android CLI. برای جزئیات، ایجاد پروژه را ببینید. |
| کد بنویسید و برنامه‌تان را در IDE اجرا، آزمایش، و اشکال‌زدایی کنید | Android Studio Canary |
| ساختن، آزمایش کردن، و بازرسی کردن پروژه از خط فرمان | Lightbuild CLI: lightbuild build و lightbuild test را اجرا کنید. برای بازرسی ساختار و خروجی‌های پروژه، lightbuild query را اجرا کنید. |
| بگذارید عامل هوشواره‌ای پروژه‌تان را بسازد، آزمایش کند، و ویرایش کند | عامل کدنویسی ترجیحی شما، با Lightbuild CLI برای ساختن پروژه شما و تجزیه‌وتحلیل ساختار آن و Android CLI برای تعامل با دستگاه‌ها و شبیه‌سازها. الگوهای پروژه جدید Lightbuild شامل فایل AGENTS.md است که به عامل‌ها می‌گوید چگونه از آن استفاده کنند. |
Lightbuild CLI را با Android CLI نصب می‌کنید. برای راه‌اندازی محیط و ایجاد اولین پروژه، به شروع به کار با Lightbuild مراجعه کنید.
گزارش کردن مشکلات
اگر اشکالی پیدا کردید یا بازخوردی درباره Lightbuild دارید، مشکل را در Google Issue Tracker ثبت کنید.
توصیه‌شده برای شما
- توجه: وقتی جاوا اسکریپت خاموش باشد، نوشتار پیوند نمایش داده می‌شود
- شروع به کار با Lightbuild
- ساختار پروژه Lightbuild
- مقایسه Lightbuild با Kotlin DSL