Обзор Lightbuild

Lightbuild – это декларативная система сборки для проектов для Android, которая упрощает чтение и редактирование конфигурации сборки как для вас, так и для ваших агентов. Вы описываете проект в файлах YAML, а затем собираете его с помощью Android Studio Canary или Lightbuild CLI.

Как работает Lightbuild

При создании нового проекта обычно используется Kotlin DSL – официально поддерживаемый и рекомендуемый язык конфигурации сборки Android. Lightbuild – это экспериментальная альтернатива, в которой используется другой подход.

Файлы конфигурации Lightbuild декларативны: вместо того чтобы писать исполняемую логику сборки, вы объявляете, что содержит ваш проект и как его следует собирать. В проекте Lightbuild используются следующие файлы:

  • project.lightbuild.yaml – файл в корневом каталоге проекта, в котором определяются настройки на уровне проекта, например модули проекта, хранилища для получения зависимостей и версия Lightbuild.
  • lightbuild.yaml – файл в каждом модуле, который определяет тип модуля, настройки Android, зависимости и тесты.
  • resolved.deps – автоматически создаваемый файл в каждом модуле, управляемом Lightbuild. В нем записываются разрешенные зависимости, поэтому их не нужно разрешать повторно при открытии или сборке. Не редактируйте его вручную.

Подробную информацию можно найти в статьях Структура проекта Lightbuild и Справочник по конфигурации Lightbuild.

Преимущества

Благодаря декларативным файлам конфигурации в формате YAML Lightbuild предлагает ряд преимуществ для рабочих процессов с агентами и пользователей Android Studio Canary:

  • Конфигурация, удобная для агентов. Файлы конфигурации сборки Lightbuild на основе YAML и мощный интерфейс командной строки разработаны для того, чтобы ИИ-агенты могли более эффективно анализировать конфигурацию сборки, понимать макет и выходные данные проекта, обновлять зависимости и редактировать модули под вашим контролем.
  • Встроен в Android Studio. Проекты Lightbuild полностью поддерживаются в Android Studio Canary. Декларативная архитектура Lightbuild ускоряет открытие проектов и устраняет необходимость вручную синхронизировать изменения конфигурации, что позволяет вам не отвлекаться от работы.
  • Рабочие процессы в командной строке. Создавайте, тестируйте и проверяйте проекты Lightbuild в терминале с помощью Lightbuild CLI или поручите это ИИ-агентам. Кроме того, проекты 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.
Поручите ИИ-агенту создать, протестировать и отредактировать проект. Ваш любимый агент для написания кода с Lightbuild CLI для создания проекта и анализа его структуры и Android CLI для взаимодействия с устройствами и эмуляторами. Шаблоны новых проектов Lightbuild включают файл AGENTS.md, который сообщает агентам, как его использовать.

Lightbuild CLI устанавливается вместе с Android CLI. Чтобы настроить среду и создать первый проект, ознакомьтесь с руководством по началу работы с Lightbuild.

Сообщить о проблемах

Если вы обнаружите ошибку или захотите оставить отзыв о Lightbuild, сообщите о проблеме в системе отслеживания ошибок Google.