Lightbuild CLI 참조

Lightbuild CLI는 Lightbuild의 공식 명령줄 도구입니다. 이 페이지에서는 명령어와 옵션을 설명합니다. Lightbuild CLI를 설치하려면 Lightbuild CLI 설치를 참고하세요. 프로젝트 빌드 및 테스트와 같은 일반적인 작업은 명령줄에서 Lightbuild 프로젝트 빌드를 참고하세요.

구문

Lightbuild CLI는 다음 문법을 사용합니다.

lightbuild [-V] [--project=path] [COMMAND]

다음과 같은 전역 옵션을 지원합니다.

옵션 설명
--version -V 버전 정보를 출력하고 종료합니다.
--project=path -p 프로젝트의 절대 경로입니다. 기본값은 현재 디렉터리이며 프로젝트를 포함해야 합니다.

사용 가능한 명령어를 나열하려면 lightbuild help를 실행합니다. 특정 명령어에 대한 도움말을 보려면 lightbuild help [command]를 실행합니다.

lightbuild build

프로젝트에서 타겟을 빌드합니다.

lightbuild build [target]
인수 설명
target 빌드할 타겟입니다. 기본값은 현재 디렉터리 아래의 모든 타겟입니다.

예를 들어 app 모듈을 빌드하려면 다음을 실행합니다.

lightbuild build app

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

lightbuild build

lightbuild clean

프로젝트의 빌드 출력 및 캐시를 삭제합니다.

lightbuild clean [target]
인수 설명
target 정리할 타겟입니다. 기본값은 현재 디렉터리 아래의 모든 타겟입니다.

예를 들어 전체 프로젝트의 빌드 출력과 캐시를 삭제하려면 다음을 실행합니다.

lightbuild clean

lightbuild help

사용 가능한 명령어를 나열하거나 특정 명령어에 대한 도움말을 표시합니다.

lightbuild help [COMMAND]
인수 설명
COMMAND 도움말을 표시할 명령어입니다. 기본값은 모든 명령어입니다.

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

lightbuild help

query와 같은 특정 명령어에 대한 도움말을 표시하려면 다음을 실행합니다.

lightbuild help query

lightbuild query

프로젝트 모듈 전체에서 패턴과 일치하는 빌드 타겟, 생성된 출력 파일 또는 소스 세트를 나열합니다.

lightbuild query [target-pattern] [--format=format] [--output=type]
옵션 또는 인수 설명
target-pattern 대상 경로 패턴입니다(예: ... 또는 app).
--format=format 출력 형식(예: json)입니다. 기본값은 테이블입니다.
--output=type 출력 형식입니다. 일치하는 타겟이 생성하는 파일의 위치는 files, 소스 세트는 sourcesets, 소스 세트의 유형은 sourceset_types입니다.

프로젝트의 모든 대상을 나열하려면 다음을 실행합니다.

lightbuild query ...

app 타겟이 생성하는 파일의 위치를 출력하려면 다음을 실행합니다.

lightbuild query app --output=files

lightbuild resolve

프로젝트의 외부 종속 항목을 해결하고 모듈의 오프라인 종속 항목 잠금 파일 (resolved.deps)을 생성합니다.

lightbuild resolve [--cache=path] [--locked-dependencies] [target]
옵션 또는 인수 설명
target 종속 항목을 해결할 모듈입니다(예: app). 기본값은 현재 디렉터리 아래의 모든 타겟입니다.
--locked-dependencies 로컬 종속 항목 잠금 파일 (resolved.deps)이 동기화되지 않은 경우 오류와 함께 종료됩니다.
--cache=path 종속 항목 캐시를 저장할 디렉터리입니다.

예를 들어 프로젝트의 모든 모듈에 대한 resolved.deps 파일을 생성하려면 다음을 실행합니다.

lightbuild resolve

resolved.deps 파일에 관한 자세한 내용은 확인된 종속 항목을 참고하세요.

lightbuild test

프로젝트에서 테스트를 실행합니다. 개발 머신에서 실행되는 로컬 테스트와 연결된 기기 또는 실행 중인 에뮬레이터에서 실행되는 계측 테스트가 있습니다. 하나의 모듈을 테스트하려면 타겟(예: app-core)을 지정합니다. 한 가지 유형의 테스트만 실행하려면 로컬 테스트의 경우 :hostTest를, 계측 테스트의 경우 :deviceTest를 타겟에 추가합니다.

lightbuild test [target] [--locked-dependencies]
옵션 또는 인수 설명
target 테스트할 타겟입니다. 기본값은 프로젝트의 모든 테스트입니다.
--locked-dependencies 로컬 종속 항목 잠금 파일 (resolved.deps)이 동기화되지 않으면 빌드가 실패합니다.

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

lightbuild test

app-core 모듈에서 로컬 테스트를 실행하려면 다음을 실행합니다.

lightbuild test app-core:hostTest

기기 또는 에뮬레이터에서 app-core 모듈의 계측 테스트를 실행하려면 다음을 실행합니다.

lightbuild test app-core:deviceTest