Lightbuild 개요

Lightbuild는 Android 프로젝트를 위한 선언적 빌드 환경으로, 개발자와 에이전트가 빌드 구성을 더 쉽게 읽고 수정할 수 있도록 합니다. YAML 파일에서 프로젝트를 설명한 다음 Android 스튜디오 Canary 또는 Lightbuild CLI로 빌드합니다.

Lightbuild 작동 방식

새 프로젝트를 만들 때는 일반적으로 Android에서 공식적으로 지원하고 권장하는 빌드 구성 언어인 Kotlin DSL을 사용합니다. Lightbuild는 다른 접근 방식을 취하는 실험적인 대안입니다.

Lightbuild 구성 파일은 선언적입니다. 실행 가능한 빌드 로직을 작성하는 대신 프로젝트에 포함된 내용과 빌드 방법을 선언합니다. Lightbuild 프로젝트는 다음 파일을 사용합니다.

  • project.lightbuild.yaml: 프로젝트의 모듈, 종속 항목을 가져올 저장소, Lightbuild 버전과 같은 프로젝트 전체 설정을 정의하는 프로젝트 루트 디렉터리의 파일입니다.
  • lightbuild.yaml: 모듈의 유형, Android 설정, 종속 항목, 테스트를 정의하는 각 모듈의 파일입니다.
  • resolved.deps: Lightbuild에서 관리하는 각 모듈에서 자동 생성되는 파일로, 해결된 종속 항목을 기록하여 열기 또는 빌드 시 다시 해결할 필요가 없습니다. 수동으로 수정하지 마세요.

자세한 내용은 Lightbuild 프로젝트 구조 및 Lightbuild 구성 참조를 참고하세요.

이점

Lightbuild는 선언적 YAML 기반 구성 파일을 사용하여 에이전트 워크플로 및 Android 스튜디오 Canary 사용자에게 다음과 같은 이점을 제공합니다.

  • 에이전트 친화적인 구성: Lightbuild의 YAML 기반 빌드 구성 파일과 강력한 명령줄 인터페이스는 AI 에이전트가 빌드 구성을 더 효율적으로 파싱하고, 프로젝트 레이아웃과 출력을 이해하고, 종속 항목을 업데이트하고, 모듈을 수정할 수 있도록 설계되었습니다. 이 모든 작업은 개발자의 제어하에 이루어집니다.
  • Android 스튜디오에 내장: Lightbuild 프로젝트는 Android 스튜디오 Canary에서 완전히 지원됩니다. Lightbuild의 선언적 아키텍처는 프로젝트 열기를 가속화하고 구성 변경 후 수동으로 동기화할 필요가 없으므로 흐름을 유지할 수 있습니다.
  • 명령줄 워크플로: Lightbuild CLI를 사용하여 터미널에서 Lightbuild 프로젝트를 빌드, 테스트, 검사하거나 AI 에이전트가 대신 수행하도록 합니다. 또한 Lightbuild 프로젝트는 Android CLI 및 유용한 개발 기능 모음과 완전히 호환됩니다.
  • 사전 해결된 종속 항목: Lightbuild는 종속 항목을 사전에 해결하고 각 모듈의 resolved.deps 파일에 기록합니다. 이러한 파일을 버전 제어에 체크인하면 프로젝트가 동적 확인을 완전히 우회하므로 더 빠르게 열고 빌드할 수 있습니다.

Lightbuild 사용 방법

Lightbuild는 Android 스튜디오 Canary, Lightbuild CLI, Android CLI와 함께 또는 별도로 사용할 수 있습니다. 다음 표에서는 일반적인 작업에 권장되는 도구를 보여줍니다.

수행하려는 작업 권장 도구
Lightbuild 프로젝트 만들기 Android 스튜디오 Canary 또는 Android CLI 자세한 내용은 프로젝트 만들기를 참고하세요.
IDE에서 코드를 작성하고 앱을 실행, 테스트, 디버그합니다. Android 스튜디오 Canary
명령줄에서 프로젝트 빌드, 테스트, 검사 Lightbuild CLI: lightbuild build 및 lightbuild test를 실행합니다. 프로젝트의 구조와 출력을 검사하려면 lightbuild query를 실행합니다.
AI 에이전트가 프로젝트를 빌드, 테스트, 수정하도록 하기 프로젝트를 빌드하고 구조를 분석하는 Lightbuild CLI와 기기 및 에뮬레이터와 상호작용하는 Android CLI가 포함된 선호하는 코딩 에이전트입니다. Lightbuild 새 프로젝트 템플릿에는 에이전트에게 사용 방법을 알려주는 AGENTS.md 파일이 포함되어 있습니다.

Android CLI를 사용하여 Lightbuild CLI를 설치합니다. 환경을 설정하고 첫 번째 프로젝트를 만들려면 Lightbuild 시작하기를 참고하세요.

문제 신고

버그를 발견하거나 Lightbuild에 관한 의견이 있으면 Google Issue Tracker에서 문제를 신고하세요.