Panoramica di Lightbuild

Lightbuild è un'esperienza di compilazione dichiarativa per i progetti Android che semplifica la lettura e la modifica della configurazione di compilazione sia per te che per i tuoi agenti. Descrivi il tuo progetto nei file YAML, quindi crealo con Android Studio Canary o l'interfaccia a riga di comando Lightbuild.

Come funziona Lightbuild

Quando crei un nuovo progetto, in genere utilizzi il linguaggio di configurazione di compilazione ufficialmente supportato e consigliato di Android, Kotlin DSL. Lightbuild è un'alternativa sperimentale che adotta un approccio diverso.

I file di configurazione di Lightbuild sono dichiarativi: invece di scrivere una logica di build eseguibile, dichiari i contenuti del progetto e come deve essere creata la build. Un progetto Lightbuild utilizza i seguenti file:

  • project.lightbuild.yaml: un file nella directory root del progetto che definisce le impostazioni a livello di progetto, come i moduli del progetto, i repository da cui ottenere le dipendenze e la versione di Lightbuild.
  • lightbuild.yaml: un file in ogni modulo che definisce il tipo, le impostazioni Android, le dipendenze e i test del modulo.
  • resolved.deps: un file generato automaticamente in ogni modulo gestito da Lightbuild che registra le dipendenze risolte, evitando la necessità di risolverle nuovamente all'apertura o alla build. Non modificarlo manualmente.

Per saperne di più, consulta Struttura del progetto Lightbuild e il Riferimento alla configurazione di Lightbuild.

Vantaggi

Utilizzando file di configurazione dichiarativi basati su YAML, Lightbuild offre diversi vantaggi per gli Agentic Workflows e gli utenti di Android Studio Canary:

  • Configurazione adatta agli agenti: i file di configurazione di compilazione basati su YAML di Lightbuild e la potente interfaccia a riga di comando sono progettati per consentire agli agenti AI di analizzare in modo più efficiente la configurazione di compilazione, comprendere il layout e gli output del progetto, aggiornare le dipendenze e modificare i moduli, tutto sotto il tuo controllo.
  • Integrato in Android Studio: i progetti Lightbuild sono completamente supportati in Android Studio Canary. L'architettura dichiarativa di Lightbuild accelera l'apertura dei progetti ed elimina la necessità di sincronizzare manualmente dopo le modifiche alla configurazione, mantenendo il flusso di lavoro.
  • Workflow da riga di comando: crea, testa e ispeziona i progetti Lightbuild dal tuo terminale con l'interfaccia a riga di comando di Lightbuild o lascia che siano i tuoi agenti AI a farlo per te. Inoltre, i progetti Lightbuild sono completamente compatibili con la CLI Android e la sua potente suite di utili funzionalità di sviluppo.
  • Dipendenze pre-risolte: Lightbuild risolve le dipendenze in modo proattivo e le registra in un file resolved.deps per ogni modulo. Se esegui il check-in di questi file nel controllo della versione, il tuo progetto ignora completamente la risoluzione dinamica, consentendo un'apertura e una creazione più rapide.

Modi per utilizzare Lightbuild

Puoi utilizzare Lightbuild con Android Studio Canary, l'interfaccia a riga di comando Lightbuild e la CLI Android, separatamente o insieme. La tabella seguente consiglia uno strumento per le attività comuni:

Cosa vorresti fare Strumento consigliato
Crea un progetto Lightbuild Android Studio Canary o CLI Android. Per maggiori dettagli, consulta Crea un progetto.
Scrivi il codice ed esegui, testa e fai il debug della tua app in un IDE Android Studio Canary
Crea, testa e ispeziona il tuo progetto dalla riga di comando Interfaccia a riga di comando Lightbuild: esegui lightbuild build e lightbuild test. Per esaminare la struttura e gli output del progetto, esegui lightbuild query.
Chiedi a un agente AI di creare, testare e modificare il tuo progetto Il tuo agente di programmazione preferito, con la CLI Lightbuild per creare il tuo progetto e analizzarne la struttura e la CLI Android per interagire con dispositivi ed emulatori. I nuovi modelli di progetto Lightbuild includono un file AGENTS.md che indica agli agenti come utilizzarlo.

Installa la CLI Lightbuild con la CLI Android. Per configurare l'ambiente e creare il tuo primo progetto, consulta Inizia a utilizzare Lightbuild.

Segnala problemi

Se trovi un bug o hai un feedback su Lightbuild, segnala un problema in Google Issue Tracker.