Tài liệu tham khảo về Lightbuild CLI

Lightbuild CLI là công cụ dòng lệnh chính thức cho Lightbuild. Trang này mô tả các lệnh và tuỳ chọn của công cụ này. Để cài đặt Lightbuild CLI, hãy xem phần Cài đặt Lightbuild CLI. Đối với các tác vụ phổ biến, chẳng hạn như tạo và kiểm thử dự án, hãy xem bài viết Tạo dự án Lightbuild từ dòng lệnh.

Cú pháp

Lightbuild CLI sử dụng cú pháp sau:

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

Công cụ này hỗ trợ các tuỳ chọn chung sau:

Lựa chọn Mô tả
-V, --version In thông tin phiên bản rồi thoát.
-p, --project=path Đường dẫn tuyệt đối đến dự án của bạn. Mặc định là thư mục hiện tại, thư mục này phải chứa một dự án.

Để liệt kê các lệnh hiện có, hãy chạy lightbuild help. Để được trợ giúp về một lệnh cụ thể, hãy chạy lightbuild help [command].

lightbuild build

Tạo một mục tiêu trong dự án của bạn.

lightbuild build [target]
Đối số Mô tả
target Mục tiêu cần tạo. Mặc định là tất cả mục tiêu bên dưới thư mục hiện tại.

Ví dụ: để tạo mô-đun app, hãy chạy:

lightbuild build app

Để tạo tất cả mục tiêu trong dự án, hãy chạy:

lightbuild build

lightbuild clean

Xoá kết quả bản dựng và bộ nhớ đệm của dự án.

lightbuild clean [target]
Đối số Mô tả
target Mục tiêu cần dọn dẹp. Mặc định là tất cả mục tiêu bên dưới thư mục hiện tại.

Ví dụ: để xoá kết quả bản dựng và bộ nhớ đệm cho toàn bộ dự án, hãy chạy:

lightbuild clean

lightbuild help

Liệt kê các lệnh có sẵn hoặc hiển thị thông tin trợ giúp cho một lệnh cụ thể.

lightbuild help [COMMAND]
Đối số Mô tả
COMMAND Lệnh để hiện thông tin trợ giúp. Mặc định là tất cả lệnh.

Để liệt kê các lệnh có sẵn cho dự án, hãy chạy:

lightbuild help

Để hiện thông tin trợ giúp cho một lệnh cụ thể, chẳng hạn như query, hãy chạy:

lightbuild help query

lightbuild query

Liệt kê các mục tiêu bản dựng, tệp đầu ra được tạo hoặc nhóm tài nguyên khớp với một mẫu trên các mô-đun của dự án.

lightbuild query [target-pattern] [--format=format] [--output=type]
Tuỳ chọn hoặc đối số Mô tả
target-pattern Mẫu đường dẫn mục tiêu, ví dụ: ... hoặc app.
--format=format Định dạng đầu ra, ví dụ: json. Mặc định là một bảng.
--output=type Định dạng của kết quả: files cho vị trí của các tệp mà mục tiêu trùng khớp tạo ra, sourcesets cho nhóm tài nguyên của các tệp đó hoặc sourceset_types cho loại nhóm tài nguyên của các tệp đó.

Để liệt kê tất cả mục tiêu trong dự án, hãy chạy lệnh:

lightbuild query ...

Để in vị trí của các tệp mà mục tiêu app tạo ra, hãy chạy:

lightbuild query app --output=files

lightbuild resolve

Giải quyết các phần phụ thuộc bên ngoài của dự án và tạo tệp khoá phần phụ thuộc ngoại tuyến (resolved.deps) cho các mô-đun của dự án.

lightbuild resolve [--cache=path] [--locked-dependencies] [target]
Tuỳ chọn hoặc đối số Mô tả
target Mô-đun để giải quyết các phần phụ thuộc, ví dụ: app. Mặc định là tất cả mục tiêu bên dưới thư mục hiện tại.
--locked-dependencies Thoát và báo lỗi nếu tệp khoá phần phụ thuộc cục bộ (resolved.deps) không đồng bộ hoá.
--cache=path Thư mục để lưu trữ bộ nhớ đệm phần phụ thuộc.

Ví dụ: để tạo tệp resolved.deps cho tất cả mô-đun trong dự án, hãy chạy:

lightbuild resolve

Để biết thêm thông tin về tệp resolved.deps, hãy xem phần Phần phụ thuộc đã phân giải.

lightbuild test

Chạy các chương trình kiểm thử trong dự án của bạn: chương trình kiểm thử cục bộ (chạy trên máy phát triển) và chương trình kiểm thử đo lường (chạy trên thiết bị thông minh đã kết nối hoặc trình mô phỏng đang chạy). Để kiểm thử một mô-đun, hãy chỉ định mục tiêu của mô-đun đó, chẳng hạn như app-core. Để chỉ chạy một loại kiểm thử, hãy thêm :hostTest cho kiểm thử cục bộ hoặc :deviceTest cho kiểm thử đo lường vào mục tiêu.

lightbuild test [target] [--locked-dependencies]
Tuỳ chọn hoặc đối số Mô tả
target Mục tiêu cần kiểm thử. Mặc định là tất cả các kiểm thử trong dự án của bạn.
--locked-dependencies Không tạo được bản dựng nếu tệp khoá phần phụ thuộc cục bộ (resolved.deps) không đồng bộ hoá.

Ví dụ: để chạy tất cả các bài kiểm thử trong dự án, hãy chạy:

lightbuild test

Để chạy các kiểm thử cục bộ trong mô-đun app-core, hãy chạy:

lightbuild test app-core:hostTest

Để chạy kiểm thử đo lường trong mô-đun app-core trên thiết bị hoặc trình mô phỏng, hãy chạy:

lightbuild test app-core:deviceTest