이 페이지에서는 Lightbuild 환경을 설정하고, Lightbuild 프로젝트를 만들고, 빌드 및 테스트하는 방법을 보여줍니다.
환경 설정
Lightbuild는 Android 스튜디오와 명령줄에서 작동합니다. 최상의 환경을 위해 다음 두 가지를 모두 설정하는 것이 좋습니다.
- Android 스튜디오 Canary: IDE에서 Lightbuild 프로젝트를 사용하려면 최신 Canary 버전의 Android 스튜디오를 설치하세요. Android 스튜디오의 안정화 버전은 Lightbuild 프로젝트를 지원하지 않습니다. 안정화 버전과 함께 Canary 버전을 설치할 수 있습니다.
- Lightbuild CLI: 명령줄에서 Lightbuild 프로젝트를 빌드하고 테스트하거나 AI 에이전트가 프로젝트를 작업하도록 하려면 Lightbuild CLI를 설치합니다. 먼저 Android CLI를 설치하거나
android update를 사용하여 최신 버전으로 업데이트합니다. 그런 다음 Lightbuild CLI 설치의 단계를 따릅니다.
각 작업에 사용할 도구에 관한 권장사항은 Lightbuild 사용 방법을 참고하세요.
프로젝트 만들기
Android 스튜디오 또는 Android CLI에서 Lightbuild 프로젝트를 만들 수 있습니다.
Android 스튜디오 Canary에서 프로젝트 만들기
Android 스튜디오 Canary에서 Lightbuild 프로젝트를 만들려면 다음 단계를 따르세요.
- Android 스튜디오의 Canary 버전에서 Android 스튜디오 시작 화면의 New Project를 클릭하거나 기본 메뉴에서 File > New > New Project를 선택합니다.
- Empty Activity 또는 Navigation UI Activity와 같이 Lightbuild와 호환되는 템플릿을 선택하고 Next를 클릭합니다.
- 빌드 구성 언어 목록에서 Lightbuild를 선택합니다.
- 프로젝트의 나머지 설정을 구성하고 Finish를 클릭합니다.
AI가 프로젝트를 생성하도록 하려면 AI로 새 프로젝트 만들기의 단계를 따르고 최종 구성 화면에서 빌드 구성 언어로 Lightbuild를 선택한 후 마침을 클릭합니다.
Android 스튜디오에서 프로젝트를 만든 후에는 다른 프로젝트와 마찬가지로 빌드, 실행, 테스트, 디버그할 수 있습니다.
Android CLI로 프로젝트 만들기
Android CLI로 Lightbuild 프로젝트를 만들려면 Lightbuild 템플릿 이름, 앱 이름, 만들 출력 디렉터리와 함께 android create를 실행합니다.
android create empty-activity-lightbuild --name="Lightbuild Demo" --output=lightbuild-demo
앱 빌드, 실행, 테스트
명령줄에서 프로젝트를 빌드, 실행, 테스트하려면 프로젝트의 루트 디렉터리에서 다음 명령어를 실행합니다.
app 모듈을 빌드하려면 다음을 실행합니다.
lightbuild build app
연결된 기기 또는 실행 중인 에뮬레이터에서 앱을 실행하려면 Android CLI에서 android run 명령어를 사용합니다.
android run --apks=app/build/app-debug.apk
app-core 모듈의 모든 테스트를 실행하려면 다음을 실행합니다.
lightbuild test app-core
자세한 내용은 명령줄에서 빌드를 참고하세요.
다음 단계
- Lightbuild 프로젝트 구조에서 Lightbuild 프로젝트가 어떻게 구성되는지 알아보세요.
- Lightbuild 구성 참조에서 각 빌드 파일의 설정에 관해 알아보세요.
- Kotlin DSL에 익숙하다면 Lightbuild와 Kotlin DSL 비교에서 Kotlin DSL 구성이 Lightbuild에 어떻게 매핑되는지 확인하세요.