명령줄에서 Lightbuild 프로젝트 빌드

Lightbuild CLI는 Lightbuild의 공식 명령줄 도구입니다. lightbuild 명령어를 사용하여 프로젝트를 빌드 및 테스트하고, 빌드 타겟을 찾고, 종속 항목을 해결합니다. AI 에이전트도 동일한 명령어를 실행할 수 있습니다. Lightbuild 템플릿에서 만드는 프로젝트에는 AI 에이전트에게 Lightbuild 및 Lightbuild CLI를 사용하는 방법을 알려주는 AGENTS.md 파일이 포함됩니다.

Lightbuild CLI의 명령어와 옵션에 관한 자세한 내용은 Lightbuild CLI 참조를 참고하세요.

Lightbuild CLI 설치

Lightbuild CLI는 Android CLI를 사용하여 설치하는 Android SDK 패키지로 배포됩니다. 단일 명령어로 설치 및 설정하거나 수동으로 설치할 수 있습니다.

한 번에 설치 및 설정

Lightbuild CLI를 설치하려면 운영체제에 맞는 명령어를 실행합니다. 이 명령어는 Android SDK에 Lightbuild CLI 패키지를 설치한 다음 패키지의 설정 스크립트를 실행합니다. 이 스크립트는 Lightbuild CLI를 macOS 및 Linux의 ~/.local/bin 또는 Windows의 $HOME\AppData\LightbuildCLI에 복사하고 해당 디렉터리가 PATH에 있는지 확인합니다.

  • macOS 및 Linux:

    android sdk install build/lightbuild/0.0.30 && bash "$(android info sdk)/build/lightbuild/0.0.30/cli/install.sh"

  • Windows (PowerShell):

    android sdk install build/lightbuild/0.0.30; if ($LASTEXITCODE -eq 0) { & "$(android info sdk)\build\lightbuild\0.0.30\cli\install.cmd" }; if ($LASTEXITCODE -eq 0) { $env:Path += ";$HOME\AppData\LightbuildCLI"; setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null }

  • Windows (명령 프롬프트):

    android sdk install build/lightbuild/0.0.30 && for /f "delims=" %p in ('android info sdk') do call "%p\build\lightbuild\0.0.30\cli\install.cmd" && setx LIGHTBUILD_REFRESH 1 >nul && reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f >nul

명령어가 완료되면 설치를 확인합니다.

수동 설치

또는 Lightbuild CLI를 설치하고 직접 PATH에 추가하려면 다음 단계를 따르세요.

  1. Android CLI가 없으면 설치합니다.

  2. Lightbuild 패키지를 설치합니다.

    android sdk install build/lightbuild/0.0.30

  3. Lightbuild CLI를 PATH의 디렉터리에 복사하여 모든 디렉터리에서 lightbuild를 실행할 수 있도록 합니다. 이미 PATH에 있는 디렉터리에 복사하거나 설정 스크립트에서 사용하는 것과 동일한 디렉터리를 사용할 수 있습니다.

    • macOS 및 Linux: lightbuild 파일을 ~/.local/bin에 복사합니다.

      mkdir -p ~/.local/bin
cp "$(android info sdk)/build/lightbuild/0.0.30/cli/lightbuild" ~/.local/bin/

      ~/.local/bin가 PATH에 없으면 셸의 시작 파일(예: ~/.zshrc 또는 ~/.bashrc)에 다음 줄을 추가합니다.

      export PATH="$PATH:$HOME/.local/bin"

    • Windows: PowerShell에서 다음 명령어를 실행합니다. lightbuild.exe를 $HOME\AppData\LightbuildCLI에 복사하고, 아직 없는 경우 해당 디렉터리를 사용자 Path에 추가한 다음, 현재 세션과 나중에 여는 터미널에 변경사항을 적용합니다.

      $dir = "$HOME\AppData\LightbuildCLI"
New-Item -ItemType Directory -Force $dir | Out-Null
Copy-Item "$(android info sdk)\build\lightbuild\0.0.30\cli\lightbuild.exe" $dir
$userPath = (Get-ItemProperty HKCU:\Environment).Path
if (($userPath -split ";") -notcontains $dir) { Set-ItemProperty HKCU:\Environment Path "$userPath;$dir" -Type ExpandString }
setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null
$env:Path += ";$dir"

  4. 설치 확인

설치 확인

Lightbuild CLI가 설치되어 있는지 확인하려면 버전을 확인합니다.

lightbuild --version

터미널에서 lightbuild 명령어를 찾을 수 없는 경우 새 터미널 창을 열어 PATH 변경사항을 적용합니다.

프로젝트의 빌드 타겟 찾기

Lightbuild CLI 명령어는 빌드, 테스트 또는 검사할 프로젝트 부분을 식별하는 타겟을 사용합니다. 타겟은 app과 같은 모듈 이름이거나 app:app-debug.apk과 같이 더 구체적인 이름일 수 있습니다. 모듈의 모든 타겟을 일치시키려면 모듈 이름 뒤에 /...를 사용합니다(예: app/...). 프로젝트의 모든 타겟을 일치시키려면 ...를 사용합니다.

프로젝트의 모든 타겟을 나열하려면 프로젝트의 루트 디렉터리에서 쿼리합니다.

lightbuild query ...

타겟이 생성하는 파일을 나열하려면 --output=files를 추가합니다. 예를 들어 app 타겟의 경우 다음을 실행합니다.

lightbuild query app --output=files

프로젝트에 사용할 수 있는 명령어를 나열하려면 lightbuild help를 실행합니다.

앱 빌드

타겟을 빌드하려면 타겟과 함께 lightbuild build를 실행합니다. 예를 들어 app 모듈을 빌드하려면 다음을 실행합니다.

lightbuild build app

프로젝트의 모든 타겟을 빌드하려면 다음을 실행합니다.

lightbuild build

Google Play에 업로드할 수 있는 서명된 출시 App Bundle을 빌드하려면 Lightbuild 앱 게시를 참고하세요.

프로젝트의 빌드 출력 및 캐시를 삭제하려면 다음을 실행합니다.

lightbuild clean

앱 실행

Lightbuild CLI는 앱을 빌드하지만 설치하거나 실행하지는 않습니다. 연결된 기기나 실행 중인 에뮬레이터에서 앱을 실행하려면 앱을 빌드한 후 Android CLI에서 android run 명령어로 실행합니다.

lightbuild build app
android run --apks=app/build/app-debug.apk

모듈의 각 타겟이 출력을 쓰는 위치를 확인하려면 lightbuild query app/... --output=files를 실행합니다. 위치는 모듈 디렉터리를 기준으로 합니다.

테스트 실행

프로젝트의 모든 테스트를 실행하려면 다음을 실행합니다.

lightbuild test

이 명령어는 개발 머신에서 실행되는 로컬 테스트와 연결된 기기 또는 실행 중인 에뮬레이터에서 실행되는 계측 테스트를 실행합니다.

한 모듈에서 테스트를 실행하려면 모듈의 타겟(예: app-core)을 추가합니다. 한 가지 유형의 테스트만 실행하려면 로컬 테스트의 경우 :hostTest를, 계측 테스트의 경우 :deviceTest를 모듈의 타겟에 추가합니다. 예를 들면 다음과 같습니다.

lightbuild test app-core:hostTest
lightbuild test app-core:deviceTest

종속 항목 해결

각 모듈은 확인된 종속 항목을 resolved.deps 파일에 기록합니다. 모듈의 resolved.deps 파일을 생성하려면 모듈의 타겟으로 lightbuild resolve를 실행합니다. 예를 들어 app 모듈의 경우 다음을 실행합니다.

lightbuild resolve app

프로젝트의 모든 타겟을 확인하려면 다음을 실행합니다.

lightbuild resolve

자세한 내용은 확인된 종속 항목을 참고하세요.