本頁面說明如何設定 Lightbuild 環境、建立 Lightbuild 專案,以及建構和測試專案。
設定環境
Lightbuild 可在 Android Studio 和指令列中運作。為獲得最佳體驗,建議您同時設定以下兩項:
- Android Studio Canary:如要在 IDE 中使用 Lightbuild 專案,請安裝最新 Canary 版 Android Studio。Android Studio 穩定版不支援 Lightbuild 專案。您可以一併安裝 Canary 版和穩定版。
- Lightbuild CLI:如要透過指令列建構及測試 Lightbuild 專案,或讓 AI 代理處理這些專案,請安裝 Lightbuild CLI。首先,請安裝 Android CLI,或使用
android update更新至最新版本。接著,請按照「安裝 Lightbuild CLI」中的步驟操作。
如需各項工作建議使用的工具,請參閱「Lightbuild 使用方式」。
建立專案
您可以在 Android Studio 中或使用 Android CLI 建立 Lightbuild 專案。
在 Android Studio Canary 中建立專案
如要在 Android Studio Canary 中建立 Lightbuild 專案,請按照下列步驟操作:
- 在 Android Studio Canary 版本中,按一下 Android Studio 歡迎畫面上的「New Project」,或從主選單中依序選取「File」>「New」>「New Project」。
- 選取與 Lightbuild 相容的範本,例如「Empty Activity」或「Navigation UI Activity」,然後點選「Next」。
- 在「建構設定語言」清單中,選取「Lightbuild」。
- 調整專案的其他設定,然後按一下「Finish」。
如要改用 AI 生成專案,請按照「使用 AI 建立新專案」中的步驟操作,並在最後的設定畫面上選取「Lightbuild」做為建構設定語言,然後按一下「Finish」。
Android Studio 建立專案後,您可以像建構、執行、測試及偵錯其他專案一樣,對該專案執行這些操作。
使用 Android CLI 建立專案
如要使用 Android CLI 建立 Lightbuild 專案,請執行 android create,並指定 Lightbuild 範本名稱、應用程式名稱和要建立的輸出目錄:
android create empty-activity-lightbuild --name="Lightbuild Demo" --output=lightbuild-demo
建構、執行及測試應用程式
如要透過指令列建構、執行及測試專案,請從專案的根目錄執行下列指令。
如要建構 app 模組,請執行:
lightbuild build app
如要在連結裝置或執行中的模擬器上執行應用程式,請在 Android CLI 中使用 android run 指令:
android run --apks=app/build/app-debug.apk
如要執行 app-core 模組中的所有測試,請執行:
lightbuild test app-core
詳情請參閱「透過指令列建構」。
後續步驟
- 如要瞭解 Lightbuild 專案的結構,請參閱「Lightbuild 專案結構」。
- 如要瞭解各個建構檔案中的設定,請參閱 Lightbuild 設定參考資料。
- 如果您熟悉 Kotlin DSL,請參閱「比較 Lightbuild 與 Kotlin DSL」,瞭解 Kotlin DSL 設定如何對應至 Lightbuild。