Visão geral do Lightbuild

O Lightbuild é uma experiência de build declarativa para projetos do Android que facilita a leitura e a edição da configuração do build para você e seus agentes. Você descreve seu projeto em arquivos YAML e o cria com o Android Studio Canary ou a CLI do Lightbuild.

Como o Lightbuild funciona

Ao criar um novo projeto, você geralmente usa a DSL do Kotlin, a linguagem de configuração do build oficialmente recomendada e com suporte do Android. O Lightbuild é uma alternativa experimental que adota uma abordagem diferente.

Os arquivos de configuração do Lightbuild são declarativos: em vez de escrever uma lógica de build executável, você declara o que seu projeto contém e como ele precisa ser criado. Um projeto do Lightbuild usa os seguintes arquivos:

  • project.lightbuild.yaml: um arquivo no diretório raiz do projeto que define as configurações do projeto, como os módulos, os repositórios de onde as dependências são extraídas e a versão do Lightbuild.
  • lightbuild.yaml: um arquivo em cada módulo que define o tipo, as configurações do Android, as dependências e os testes do módulo.
  • resolved.deps: um arquivo gerado automaticamente em cada módulo gerenciado pelo Lightbuild que registra as dependências resolvidas, evitando a necessidade de resolvê-las novamente ao abrir ou criar. Não edite manualmente.

Para mais informações, consulte a estrutura do projeto do Lightbuild e a referência de configuração do Lightbuild.

Vantagens

Ao usar arquivos de configuração declarativos baseados em YAML, o Lightbuild oferece vários benefícios para Agentic Workflows e usuários do Android Studio Canary:

  • Configuração compatível com agentes: os arquivos de configuração de build baseados em YAML do Lightbuild e a poderosa interface de linha de comando foram projetados para permitir que os agentes de IA analisem sua configuração de build com mais eficiência, entendam o layout e as saídas do projeto, atualizem dependências e editem módulos, tudo sob seu controle.
  • Integrado ao Android Studio: os projetos do Lightbuild são totalmente compatíveis com o Android Studio Canary. A arquitetura declarativa do Lightbuild acelera a abertura de projetos e elimina a necessidade de sincronização manual após mudanças de configuração, mantendo você no fluxo.
  • Fluxos de trabalho de linha de comando: crie, teste e inspecione projetos do Lightbuild no terminal com a CLI do Lightbuild ou peça para os agentes de IA fazerem isso por você. Além disso, os projetos do Lightbuild são totalmente compatíveis com a CLI do Android e o conjunto avançado de recursos de desenvolvimento úteis.
  • Dependências pré-resolvidas: o Lightbuild resolve suas dependências de forma proativa e as registra em um arquivo resolved.deps para cada módulo. Ao verificar esses arquivos no controle de versões, seu projeto ignora totalmente a resolução dinâmica, o que permite que ele seja aberto e criado mais rapidamente.

Formas de usar o Lightbuild

Você pode usar o Lightbuild com o Android Studio Canary, a CLI do Lightbuild e a CLI do Android, separadamente ou em conjunto. A tabela a seguir recomenda uma ferramenta para tarefas comuns:

O que você quer fazer. Ferramenta recomendada
Criar um projeto do Lightbuild Android Studio Canary ou CLI do Android. Consulte Criar um projeto para mais detalhes.
Escrever código, executar, testar e depurar o app em um ambiente de desenvolvimento integrado Android Studio Canary
Criar, testar e inspecionar seu projeto na linha de comando CLI do Lightbuild: execute lightbuild build e lightbuild test. Para inspecionar a estrutura e as saídas do projeto, execute lightbuild query.
Peça para um agente de IA criar, testar e editar seu projeto Seu agente de programação preferido, com a CLI do Lightbuild para criar seu projeto e analisar a estrutura dele, e a CLI do Android para interagir com dispositivos e emuladores. Os novos modelos de projeto do Lightbuild incluem um arquivo AGENTS.md que informa aos agentes como usá-lo.

Instale a CLI do Lightbuild com a CLI do Android. Para configurar seu ambiente e criar seu primeiro projeto, consulte Começar a usar o Lightbuild.

Relatar problemas

Se você encontrar um bug ou tiver feedback sobre o Lightbuild, registre um problema no Issue Tracker do Google.