Lightbuild 總覽

Lightbuild 是 Android 專案的宣告式建構體驗,可讓您和代理輕鬆讀取及編輯建構設定。您可以在 YAML 檔案中描述專案,然後使用 Android Studio Canary 或 Lightbuild CLI 建構專案。

Lightbuild 的運作方式

建立新專案時,通常會使用 Android 官方支援和建議的建構設定語言 Kotlin DSL。Lightbuild 則是實驗性質的替代方案,採用不同的做法。

Lightbuild 設定檔是宣告式:您不必編寫可執行的建構邏輯,而是宣告專案包含的內容,以及建構方式。Lightbuild 專案會使用下列檔案:

  • project.lightbuild.yaml:專案根目錄中的檔案,用於定義專案層級設定,例如專案模組、依附元件來源存放區,以及 Lightbuild 版本。
  • lightbuild.yaml:每個模組中的檔案,用於定義模組類型、Android 設定、依附元件和測試。
  • resolved.deps:Lightbuild 管理的每個模組中,都會自動產生這個檔案,記錄已解析的依附元件,避免在開啟或建構時重新解析。請勿手動編輯。

詳情請參閱「Lightbuild 專案結構」和「Lightbuild 設定參考資料」。

優點

Lightbuild 採用宣告式 YAML 設定檔,為 Agentic Workflows 和 Android Studio Canary 使用者帶來多項優勢:

  • 適合代理的設定:Lightbuild 採用 YAML 建構設定檔和強大的指令列介面,可讓 AI 代理更有效率地剖析建構設定、瞭解專案版面配置和輸出內容、更新依附元件,以及編輯模組,一切都在您的掌控之中。
  • 內建於 Android Studio:Android Studio Canary 完整支援 Lightbuild 專案。Lightbuild 的宣告式架構可加快專案開啟速度,且變更設定後不必手動同步,讓您保持流暢的工作流程。
  • 指令列工作流程:使用 Lightbuild CLI 從終端機建構、測試及檢查 Lightbuild 專案,或交由 AI 代理處理。此外,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。
讓 AI 代理建構、測試及編輯專案 您偏好的程式設計代理,可使用 Lightbuild CLI 建構專案並分析結構,以及使用 Android CLI 與裝置和模擬器互動。Lightbuild 新專案範本包含 AGENTS.md 檔案,可指示代理如何使用。

您可以使用 Android CLI 安裝 Lightbuild CLI。如要設定環境並建立第一個專案,請參閱「開始使用 Lightbuild」。

回報問題

如果您發現 Lightbuild 有錯誤或有相關意見,請在 Google Issue Tracker 提交問題。