このページでは、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 の使用方法をご覧ください。
プロジェクトを作成する
Lightbuild プロジェクトは、Android Studio または Android CLI で作成できます。
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] を選択してから、[完了] をクリックします。
Android Studio でプロジェクトを作成したら、他のプロジェクトと同様にビルド、実行、テスト、デバッグを行うことができます。
Android CLI でプロジェクトを作成する
Android CLI で Lightbuild プロジェクトを作成するには、Lightbuild テンプレート名、アプリの名前、作成する出力ディレクトリを指定して android create を実行します。
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 にどのようにマッピングされるかをご覧ください。