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 に組み込み: Lightbuild プロジェクトは Android Studio Canary で完全にサポートされています。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 ファイルが含まれています。

Lightbuild CLI は Android CLI でインストールします。環境を設定して最初のプロジェクトを作成するには、Lightbuild を使ってみるをご覧ください。

問題を報告する

Lightbuild に関するバグを見つけた場合やフィードバックがある場合は、Google Issue Tracker で問題を報告してください。