Lightbuild es una experiencia de compilación declarativa para proyectos de Android que facilita la lectura y edición de la configuración de compilación para ti y tus agentes. Describes tu proyecto en archivos YAML y, luego, lo compilas con Android Studio Canary o la CLI de Lightbuild.
Cómo funciona Lightbuild
Cuando creas un proyecto nuevo, sueles usar el lenguaje de configuración de compilación recomendado y compatible oficialmente con Android, el DSL de Kotlin. Lightbuild es una alternativa experimental que adopta un enfoque diferente.
Los archivos de configuración de Lightbuild son declarativos: en lugar de escribir lógica de compilación ejecutable, declaras lo que contiene tu proyecto y cómo se debe compilar. Un proyecto de Lightbuild usa los siguientes archivos:
project.lightbuild.yaml: Es un archivo en el directorio raíz de tu proyecto que define la configuración de todo el proyecto, como los módulos del proyecto, los repositorios de los que se obtienen las dependencias y la versión de Lightbuild.lightbuild.yaml: Es un archivo en cada módulo que define el tipo de módulo, la configuración de Android, las dependencias y las pruebas.resolved.deps: Es un archivo generado de forma automática en cada módulo administrado por Lightbuild que registra las dependencias resueltas, lo que evita la necesidad de volver a resolverlas cuando se abre o se compila. No lo edites de forma manual.
Para obtener más información, consulta la estructura del proyecto de Lightbuild y la referencia de configuración de Lightbuild.
Beneficios
Con archivos de configuración declarativos basados en YAML, Lightbuild proporciona varios beneficios para los flujos de trabajo de agentes y los usuarios de Android Studio Canary:
- Configuración compatible con agentes: Los archivos de configuración de compilación basados en YAML de Lightbuild y la potente interfaz de línea de comandos están diseñados para permitir que los agentes de IA analicen de forma más eficiente tu configuración de compilación, comprendan el diseño y los resultados de tu proyecto, actualicen las dependencias y editen los módulos, todo bajo tu control.
- Integración en Android Studio: Los proyectos de Lightbuild son totalmente compatibles con Android Studio Canary. La arquitectura declarativa de Lightbuild acelera la apertura de proyectos y elimina la necesidad de sincronizar manualmente después de los cambios de configuración, lo que te permite mantener el flujo de trabajo.
- Flujos de trabajo de línea de comandos: Compila, prueba e inspecciona proyectos de Lightbuild desde tu terminal con la CLI de Lightbuild o haz que tus agentes de IA lo hagan por ti. Además, los proyectos de Lightbuild son totalmente compatibles con la Android CLI y su potente conjunto de funciones de desarrollo útiles.
- Dependencias resueltas previamente: Lightbuild resuelve tus dependencias
de forma proactiva y las registra en un archivo
resolved.depspara cada módulo. Si ingresas estos archivos en el control de versiones, tu proyecto omitirá por completo la resolución dinámica, lo que permitirá que se abra y compile más rápido.
Formas de usar Lightbuild
Puedes usar Lightbuild con Android Studio Canary, la CLI de Lightbuild y la CLI de Android, por separado o en conjunto. En la siguiente tabla, se recomienda una herramienta para las tareas comunes:
| Qué quieres hacer | Herramienta recomendada |
|---|---|
| Cómo crear un proyecto de Lightbuild | Android Studio Canary o Android CLI Consulta Crea un proyecto para obtener más detalles. |
| Escribir código, y ejecutar, probar y depurar tu app en un IDE | Android Studio Canary |
| Compila, prueba e inspecciona tu proyecto desde la línea de comandos | Lightbuild CLI: Ejecuta lightbuild build y lightbuild test. Para inspeccionar la estructura y los resultados de tu proyecto, ejecuta lightbuild query. |
| Haz que un agente de IA cree, pruebe y edite tu proyecto | Tu agente de programación preferido, con la CLI de Lightbuild para compilar tu proyecto y analizar su estructura, y la CLI de Android para interactuar con dispositivos y emuladores. Las plantillas de proyectos nuevos de Lightbuild incluyen un archivo AGENTS.md que les indica a los agentes cómo usarlo. |
La CLI de Lightbuild se instala con Android CLI. Para configurar tu entorno y crear tu primer proyecto, consulta Comienza a usar Lightbuild.
Informar problemas
Si encuentras un error o tienes comentarios sobre Lightbuild, informa un problema en la Herramienta de seguimiento de errores de Google.
Recomendaciones para ti
- Nota: El texto del vínculo se muestra cuando JavaScript está desactivado
- Comienza a usar Lightbuild
- Estructura del proyecto de Lightbuild
- Compara Lightbuild con el DSL de Kotlin