Présentation de Lightbuild

Lightbuild est une expérience de compilation déclarative pour les projets Android qui facilite la lecture et la modification de la configuration de compilation pour vous et vos agents. Vous décrivez votre projet dans des fichiers YAML, puis vous le compilez avec Android Studio Canary ou la CLI Lightbuild.

Fonctionnement de Lightbuild

Lorsque vous créez un projet, vous utilisez généralement le langage de configuration de compilation officiellement compatible et recommandé par Android, à savoir le DSL Kotlin. Lightbuild est une alternative expérimentale qui adopte une approche différente.

Les fichiers de configuration Lightbuild sont déclaratifs : au lieu d'écrire une logique de compilation exécutable, vous déclarez ce que contient votre projet et comment il doit être compilé. Un projet Lightbuild utilise les fichiers suivants :

  • project.lightbuild.yaml : fichier du répertoire racine de votre projet qui définit les paramètres à l'échelle du projet, tels que les modules du projet, les dépôts à partir desquels obtenir les dépendances et la version de Lightbuild.
  • lightbuild.yaml : fichier présent dans chaque module qui définit le type du module, les paramètres Android, les dépendances et les tests.
  • resolved.deps : fichier généré automatiquement dans chaque module géré par Lightbuild qui enregistre les dépendances résolues, ce qui évite d'avoir à les résoudre à nouveau lors de l'ouverture ou de la compilation. Ne pas modifier manuellement.

Pour en savoir plus, consultez Structure d'un projet Lightbuild et la documentation de référence sur la configuration de Lightbuild.

Avantages

En utilisant des fichiers de configuration déclaratifs basés sur YAML, Lightbuild offre plusieurs avantages pour les workflows agentiques et les utilisateurs d'Android Studio Canary :

  • Configuration adaptée aux agents : les fichiers de configuration de compilation YAML de Lightbuild et son interface de ligne de commande puissante sont conçus pour permettre aux agents IA d'analyser plus efficacement votre configuration de compilation, de comprendre la mise en page et les résultats de votre projet, de mettre à jour les dépendances et de modifier les modules, le tout sous votre contrôle.
  • Intégration à Android Studio : les projets Lightbuild sont entièrement compatibles avec Android Studio Canary. L'architecture déclarative de Lightbuild accélère l'ouverture des projets et élimine le besoin de synchronisation manuelle après les modifications de configuration, ce qui vous permet de rester concentré.
  • Workflows de ligne de commande : créez, testez et inspectez des projets Lightbuild depuis votre terminal avec la CLI Lightbuild, ou laissez vos agents IA le faire pour vous. De plus, les projets Lightbuild sont entièrement compatibles avec la CLI Android et sa suite de fonctionnalités de développement utiles.
  • Dépendances pré-résolues : Lightbuild résout vos dépendances de manière proactive et les enregistre dans un fichier resolved.deps pour chaque module. En intégrant ces fichiers au contrôle des versions, votre projet contourne entièrement la résolution dynamique, ce qui lui permet de s'ouvrir et de se compiler plus rapidement.

Comment utiliser Lightbuild

Vous pouvez utiliser Lightbuild avec Android Studio Canary, la CLI Lightbuild et la CLI Android, séparément ou ensemble. Le tableau suivant recommande un outil pour les tâches courantes :

Quel est votre objectif ? Outil recommandé
Créer un projet Lightbuild Android Studio Canary ou la CLI Android. Pour en savoir plus, consultez Créer un projet.
Écrire du code, et exécuter, tester et déboguer votre application dans un IDE Android Studio Canary
Créer, tester et inspecter votre projet à partir de la ligne de commande CLI Lightbuild : exécutez lightbuild build et lightbuild test. Pour inspecter la structure et les résultats de votre projet, exécutez lightbuild query.
Faites créer, tester et modifier votre projet par un agent IA Votre agent de codage préféré, avec la CLI Lightbuild pour créer votre projet et analyser sa structure, et la CLI Android pour interagir avec les appareils et les émulateurs. Les nouveaux modèles de projet Lightbuild incluent un fichier AGENTS.md qui indique aux agents comment l'utiliser.

Vous installez la CLI Lightbuild avec la CLI Android. Pour configurer votre environnement et créer votre premier projet, consultez Premiers pas avec Lightbuild.

Signaler des problèmes

Si vous trouvez un bug ou si vous avez des commentaires sur Lightbuild, signalez un problème dans l'Issue Tracker de Google.