Tổng quan về giao diện dòng lệnh Android

Android CLI là một giao diện dòng lệnh giúp bạn dễ dàng và hiệu quả hơn trong việc tạo bản dựng cho Android bằng bất kỳ công cụ nào mà bạn chọn. Công cụ này chuẩn hoá các năng lực phát triển cốt lõi cho quy trình làm việc ưu tiên tác nhân, cung cấp điểm truy cập vào các công cụ, kỹ năng và kiến thức chính thức mà bạn cần để phát triển hiệu quả hơn. Công cụ này cũng có thể đơn giản hoá quy trình tích hợp liên tục (CI), bảo trì và mọi quy trình tự động hoá bằng tập lệnh khác cho bản chất ngày càng phân tán của quá trình phát triển Android.

Ví dụ: một tác nhân hoặc tập lệnh có thể sử dụng CLI để tự động hoá quá trình thiết lập môi trường, tạo dự án mới từ các mẫu và quản lý thiết bị ảo trực tiếp từ thiết bị đầu cuối. Công cụ này cũng cấp cho tác nhân của bạn quyền truy cập vào các kỹ năng Android và Cơ sở kiến thức chuyên biệt về Android để giúp đảm bảo rằng các dự án của bạn áp dụng các mẫu và phương pháp hay nhất do Android đề xuất.

Cài đặt Android CLI

Để cài đặt Android CLI, hãy làm theo các bước sau:

Tải Android CLI xuống.
Để đảm bảo bạn đang sử dụng phiên bản mới nhất, hãy cập nhật Android CLI:
```
android update
```
Mẹo: Chạy android update thường xuyên để cập nhật các tính năng mới nhất.

Để kiểm tra xem Android CLI đã được cài đặt trên máy của bạn hay chưa, hãy chạy which android hoặc command -v android: nếu trả về một đường dẫn, thì tức là đã cài đặt.

Thiết lập cho tác nhân

Để giúp tác nhân hiểu và sử dụng Android CLI, hãy chạy init để cài đặt kỹ năng android-cli:

android init

Vấn đề đã biết

Lệnh android emulator cho Windows hiện bị tắt.

Tuỳ chọn chung

Đây là các cờ không bắt buộc mà bạn có thể sử dụng với các lệnh Android CLI khác.

`-h, --help`

Cách sử dụng: android <command> -h

Nội dung mô tả: Hiển thị hướng dẫn trợ giúp cho công cụ hoặc lệnh cụ thể đang được đề cập.

Ví dụ:

android -h
android create -h

`--sdk`

Cách sử dụng: android --sdk=<path-to-sdk> <command>

Nội dung mô tả: Đường dẫn đến SDK Android mà bạn muốn sử dụng cho lệnh tiếp theo. Bạn có thể sử dụng chế độ cài đặt --sdk để tạm thời ghi đè SDK Android mặc định thay vì thay đổi các biến môi trường chung mỗi khi bạn muốn chuyển đổi. Để kiểm tra SDK Android mà bạn đang sử dụng theo mặc định, hãy chạy android info.

Ví dụ: android --sdk=<path/to/sdk> sdk list

Lệnh

Phần này liệt kê tất cả các lệnh Android CLI và mô tả chức năng của các lệnh đó. Tất cả các lệnh này phải được đặt trước bằng android, ví dụ: android create, android run, v.v. Các công cụ sửa đổi không bắt buộc được đặt trong dấu ngoặc vuông [] và các đối số bắt buộc thì không.

`create`

Cách sử dụng: android create [--dry-run] [--verbose] [--name=<application-name>] [--output=<dest-path>] [<template-name>]

Nội dung mô tả: Khởi chạy một dự án mới từ một mẫu. Để xem các tuỳ chọn mẫu, hãy chạy android create -h.

Đối số (bắt buộc):

-o, --output - Đường dẫn thư mục dự án đích.

Lựa chọn:

--dry-run - Mô phỏng toàn bộ quy trình tạo dự án mà không thực sự lưu bất kỳ tệp nào. Ví dụ: bạn có thể chạy thử nghiệm để xem các mẫu khác nhau hoạt động như thế nào trước khi cam kết sử dụng một mẫu.
--verbose - Bật đầu ra chi tiết, bao gồm thông tin như tệp nào đang được sao chép từ mẫu.
--name=<application-name> - Tên của thư mục dự án. Nếu bạn bỏ qua, thư mục đầu ra sẽ được sử dụng.
<template-name> - Tên của mẫu để tạo một dự án mới. Nếu bạn bỏ qua, empty-activity-agp-9 sẽ được sử dụng.

Ví dụ: android create --dry-run --verbose empty-activity-agp-9

`create list`

Cách sử dụng: android create list

Nội dung mô tả: Liệt kê tất cả các mẫu có sẵn để tạo một dự án mới.

`describe`

Cách sử dụng: android describe [--project_dir=<project-directory>]

Nội dung mô tả: Phân tích một dự án Android để tạo siêu dữ liệu mô tả. Lệnh này xác định và xuất các đường dẫn đến tệp JSON nêu chi tiết cấu trúc của dự án, bao gồm cả mục tiêu bản dựng và vị trí cấu phần phần mềm đầu ra tương ứng (ví dụ: tệp APK). Thông tin này cho phép các công cụ và lệnh khác xác định vị trí cấu phần phần mềm bản dựng một cách hiệu quả.

Lựa chọn:

--project_dir - Thư mục dự án cần mô tả. Nếu bạn bỏ qua, thư mục hiện tại sẽ được sử dụng.

Ví dụ: android describe --project_dir=/path/to/your/project

`docs`

Cách sử dụng:

android docs search <query>
android docs fetch <kb-url>

Nội dung mô tả: Lệnh android docs là một quy trình gồm 2 bước để truy cập trực tiếp Cơ sở kiến thức về Android từ CLI. Trước tiên, hãy tìm kiếm tài liệu liên quan đến truy vấn của bạn bằng lệnh search. Kết quả tìm kiếm sẽ bao gồm các URL đặc biệt bắt đầu bằng kb://, sau đó bạn có thể sử dụng các URL này với lệnh fetch để xuất các lệnh tài liệu vào thiết bị đầu cuối.

Ví dụ:

android docs search 'How do I improve my app performance?'
android docs fetch kb://android/topic/performance/overview

`emulator create`

Cách sử dụng: android emulator create [--list-profiles] [--profile=<profile-name>]

Nội dung mô tả: Tạo một thiết bị ảo.

Lựa chọn:

--list-profiles - Liệt kê các hồ sơ thiết bị có thể dùng để tạo thiết bị.
--profile=<profile-name> - Tạo một thiết bị có hồ sơ được chỉ định. Nếu bạn bỏ qua, hồ sơ medium_phone sẽ được tạo.

`emulator list`

Cách sử dụng: android emulator list

Nội dung mô tả: Liệt kê các thiết bị ảo có sẵn.

`emulator start`

Cách sử dụng: android emulator start <device-name>

Nội dung mô tả: Khởi chạy thiết bị ảo được chỉ định.

Đối số (bắt buộc):

<device-name> - Tên thiết bị cần khởi động (ví dụ: medium_phone). Sử dụng android emulator list để xem các thiết bị có sẵn.

Ví dụ: android emulator start medium_phone

`emulator stop`

Cách sử dụng: android emulator stop <device-serial-number>

Nội dung mô tả: Dừng thiết bị ảo được chỉ định.

Đối số (bắt buộc):

<device-serial-number> - Số sê-ri của thiết bị cần dừng.

Ví dụ: android emulator stop emulator-5554

`info`

Cách sử dụng: android info

Nội dung mô tả: Hiển thị đường dẫn đến SDK Android mặc định được sử dụng. Để thay đổi SDK Android được sử dụng, hãy dùng --sdk.

`init`

Cách sử dụng: android init

Nội dung mô tả: Thiết lập môi trường cho tác nhân bằng cách cài đặt kỹ năng android-cli.

`layout`

Cách sử dụng: android layout [--pretty] [--output] [--diff]

Nội dung mô tả: Trả về bố cục của giao diện người dùng của ứng dụng Android đang hoạt động (được kết nối thông qua một thiết bị thực hoặc trình mô phỏng) ở định dạng JSON.

Lựa chọn:

-p, --pretty - Định dạng đầu ra JSON bằng cách thụt lề và ngắt dòng để con người có thể đọc được.
-o, --output - Chỉ định vị trí tệp để lưu cây bố cục. Nếu bạn bỏ qua, JSON sẽ được in trực tiếp vào stdout.
-d, --diff - Chỉ trả về danh sách các thành phần bố cục đã thay đổi kể từ lần chụp nhanh nội bộ gần đây nhất (lần chạy bố cục gần đây nhất), thay vì toàn bộ cây bố cục.

Ví dụ:: android layout --output=./hierarchy.json

`skills add`

Kỹ năng Android là các hướng dẫn đặc biệt được thiết kế để giúp tác nhân hiểu rõ hơn và thực thi các mẫu cụ thể tuân theo các phương pháp hay nhất và hướng dẫn về quá trình phát triển Android. Để tìm hiểu thêm, hãy xem bài viết Giới thiệu về kỹ năng Android.

Cách sử dụng: android skills add [--all] [--agent=<agent-name>] [--skill=<skill-name>]

Nội dung mô tả: Cài đặt kỹ năng Android vào các thư mục kỹ năng cho tất cả các tác nhân được phát hiện. Nếu bạn không có thư mục tác nhân hiện có và không chỉ định tác nhân cụ thể, thì các kỹ năng sẽ được cài đặt cho Gemini và Antigravity tại ~/.gemini/antigravity/skills.

Lựa chọn:

--all - Thêm tất cả các kỹ năng Android cùng một lúc. Nếu bạn bỏ qua (và không chỉ định --skill), chỉ kỹ năng android-cli sẽ được cài đặt.
--agent - Danh sách tác nhân được phân tách bằng dấu phẩy để cài đặt kỹ năng. Nếu bạn bỏ qua, kỹ năng sẽ được cài đặt cho tất cả các tác nhân được phát hiện.
--skill - Tên kỹ năng mà bạn muốn cài đặt. Nếu bạn bỏ qua (và không chỉ định --all), chỉ kỹ năng android-cli sẽ được cài đặt.

Ví dụ: android skills add --agent='gemini' edge-to-edge

`skills find`

Cách sử dụng: android skills find <string>

Nội dung mô tả: Tìm các kỹ năng phù hợp với một chuỗi đã cho.

Đối số (bắt buộc):

string - Chuỗi phù hợp với nội dung mô tả kỹ năng.

Ví dụ: android skills find 'performance'

`skills list`

Cách sử dụng: android skills list [--long]

Nội dung mô tả: Liệt kê các kỹ năng có sẵn.

Lựa chọn:

--long - Xuất thông tin bổ sung cho mỗi kỹ năng, bao gồm nội dung mô tả kỹ năng và tác nhân đã cài đặt kỹ năng đó.

`skills remove`

Cách sử dụng: android skills remove [--agent] --skill=<skill-name>

Nội dung mô tả: Xoá một kỹ năng. Nếu bạn không chỉ định tác nhân cụ thể, kỹ năng sẽ bị xoá cho tất cả các tác nhân.

Đối số (bắt buộc):

--skill - Tên của kỹ năng cần xoá.

Lựa chọn:

--agent - Danh sách các tác nhân được phân tách bằng dấu phẩy để xoá kỹ năng. Nếu bạn bỏ qua, kỹ năng sẽ bị xoá cho tất cả các tác nhân.

Ví dụ: android skills remove --agent='gemini' --skill=edge-to-edge

`screen capture`

Cách sử dụng: android screen capture [--output] [--annotate]

Nội dung mô tả: Chụp ảnh màn hình của thiết bị thông minh đã kết nối.

Lựa chọn:

-o, --output - Chỉ định vị trí tệp để lưu ảnh chụp màn hình. Nếu bạn bỏ qua, dữ liệu PNG thô sẽ được in trực tiếp vào stdout.
-a, --annotate - Vẽ các hộp giới hạn được gắn nhãn xung quanh tất cả các thành phần trên giao diện người dùng được phát hiện trên hình ảnh, để sử dụng với lệnh resolve

Ví dụ: android screen capture --output=ui.png

`screen resolve`

Cách sử dụng: android screen resolve --screenshot=<path> --string=<string>

Nội dung mô tả: Dịch nhãn trực quan từ ảnh chụp màn hình được chú thích, được chụp bằng screen capture, thành toạ độ màn hình thực tế (x, y). Hữu ích cho việc viết tập lệnh nhấp vào các thành phần mà không cần tính toán vị trí của chúng theo cách thủ công.

Cờ:

--screenshot - Đường dẫn đến ảnh chụp màn hình được chú thích.
--string - Một chuỗi bao gồm ít nhất một phần giữ chỗ tương ứng với nhãn phần tử trên giao diện người dùng ở định dạng #<number>. Phần #<number> sẽ được thay thế bằng toạ độ màn hình.

Ví dụ:

Nếu nhãn 5 nằm ở toạ độ (500, 1000), thì lệnh

android screen resolve --screenshot=ui.png --string="input tap #5"

sẽ trả về đầu ra

input tap 500 1000

`sdk install`

Cách sử dụng: android sdk install <package[@version]> [--beta] [--canary] [--force]

Nội dung mô tả: Cài đặt(các) gói SDK được chỉ định.

Đối số (bắt buộc):

package[@version] - Danh sách các gói được phân tách bằng dấu cách để cài đặt. Nếu bạn không chỉ định phiên bản, phiên bản mới nhất của gói trong kênh (theo mặc định là kênh ổn định) sẽ được cài đặt.

Lựa chọn:

--beta - Bao gồm các gói thử nghiệm.
--canary - Bao gồm các gói canary.
--force - Buộc hạ cấp xuống phiên bản cũ hơn.

Ví dụ:

android sdk install platforms/android-34 build-tools/34.0.0 - Cài đặt các phiên bản mới nhất của gói Nền tảng SDK Android 34 và Công cụ xây dựng SDK 34.0.0 từ kênh ổn định.
android sdk install platforms/android-34@2 - Cài đặt phiên bản 2 của gói Nền tảng SDK Android 34.
android sdk install --canary system-images/android-35/google_apis/x86_6 - Cài đặt phiên bản mới nhất của hình ảnh hệ thống Android 35 từ kênh canary channel.
android sdk install --force platforms/android-33@1 - Hoàn nguyên về phiên bản 1 của gói Nền tảng SDK Android 33 từ kênh ổn định.

`sdk list`

Cách sử dụng: android sdk list <package-pattern>

Nội dung mô tả: Liệt kê các gói SDK đã cài đặt và có sẵn.

Đối số (bắt buộc):

<package-pattern> - Lọc các gói theo mẫu. Hỗ trợ biểu thức chính quy.

Lựa chọn:

--all - Hiện tất cả các gói đã cài đặt và có sẵn.
--all-versions - Hiện tất cả các phiên bản cho mỗi gói.
--beta - Bao gồm các gói thử nghiệm.
--canary - Bao gồm các gói canary.

`sdk remove`

Cách sử dụng: android sdk remove <package-name>

Nội dung mô tả: Xoá một gói khỏi SDK.

Đối số (bắt buộc):

<package-name> - Tên của gói cần xoá.

Ví dụ: android sdk remove build-tools/36.1.0

`run`

Cách sử dụng: android run [--debug] [--activity=<activity-name>] [--device=<serial-number>] [--type=<param>] --apks=<apk-paths>

Nội dung mô tả: Triển khai một ứng dụng Android cho một thiết bị thông minh hoặc trình mô phỏng đã kết nối. Lệnh này không thực hiện bất kỳ bước xây dựng nào; bạn phải cung cấp(các) đường dẫn đến tệp APK mà bạn muốn cài đặt.

Đối số (bắt buộc):

--apks - Danh sách(các) đường dẫn được phân tách bằng dấu phẩy đến các tệp APK mà bạn muốn cài đặt. Đường dẫn tương ứng với vị trí hiện tại của bạn trong hệ thống tệp.

Lựa chọn:

--activity - Tên của hoạt động cần khởi chạy sau khi cài đặt APK. Nếu có nhiều hoạt động, bạn phải chỉ định một hoạt động để khởi chạy ban đầu.
--debug - Triển khai ứng dụng ở chế độ gỡ lỗi. Sau khi chạy ứng dụng ở chế độ gỡ lỗi, bạn phải kết nối trình gỡ lỗi từ một IDE, chẳng hạn như Android Studio hoặc một công cụ dòng lệnh để bắt đầu gỡ lỗi.
--device - Số sê-ri của thiết bị mục tiêu hoặc trình mô phỏng. Chỉ cần thiết nếu kết nối nhiều thiết bị. Để tìm số sê-ri của thiết bị, hãy chạy adb devices.
--type - Loại thành phần cần khởi động. Sử dụng tuỳ chọn này nếu bạn muốn khởi động trực tiếp một dịch vụ nền thay vì một hoạt động trên giao diện người dùng. Các loại được hỗ trợ:
- ACTIVITY
- WATCH_FACE
- TILE
- COMPLICATION
- DECLARATIVE_WATCH_FACE

Ví dụ:

android run --apks=app/build/outputs/apk/debug/app-debug.apk - Triển khai một APK duy nhất cho thiết bị mặc định.
android run --apks=base.apk,density-hdpi.apk,lang-en.apk - Triển khai nhiều APK cho thiết bị mặc định.
android run --apks=app-debug.apk --type=SERVICE --activity=.sync.DataSyncService - Kiểm thử một dịch vụ mà không có hoạt động.
android run --apks=app-debug.apk --device=emulator-5554 - Triển khai APK cho một thiết bị cụ thể.

`sdk update`

Cách sử dụng: android sdk update [--beta] [--canary] [<package-name>]

Nội dung mô tả: Cập nhật một hoặc tất cả các gói lên phiên bản mới nhất trong kênh (theo mặc định là kênh ổn định). Nếu bạn không chỉ định một gói, tất cả các gói sẽ được cập nhật.

Lựa chọn:

<package-name> - Tên của gói cần cập nhật.
--beta - Bao gồm các gói thử nghiệm.
--canary - Bao gồm các gói canary.
--force - Buộc hạ cấp xuống phiên bản cũ hơn.

Ví dụ:

android sdk update - Kiểm tra và cài đặt các bản cập nhật cho mọi thứ trong SDK của bạn.
android sdk update build-tools/34.0.0 - Cập nhật gói Công cụ xây dựng SDK Android 34.0.0 lên phiên bản mới nhất trong kênh ổn định.
android sdk update --canary platforms/android-35 - Cập nhật gói Nền tảng SDK Android 35 lên phiên bản mới nhất trong kênh canary.

`update`

Cách sử dụng: android update

Nội dung mô tả: Cập nhật Android CLI.

`-V, --version`

Nội dung mô tả: Hiện phiên bản hiện tại của Android CLI.

Tổng quan về giao diện dòng lệnh Android Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Cài đặt Android CLI

Thiết lập cho tác nhân

Vấn đề đã biết

Tuỳ chọn chung

-h, --help

--sdk

Lệnh

create

create list

describe

docs

emulator create

emulator list

emulator start

emulator stop

info

init

layout

skills add

skills find

skills list

skills remove

screen capture

screen resolve

sdk install

sdk list

sdk remove

run

sdk update

update

-V, --version

Tổng quan về giao diện dòng lệnh Android

`-h, --help`

`--sdk`

`create`

`create list`

`describe`

`docs`

`emulator create`

`emulator list`

`emulator start`

`emulator stop`

`info`

`init`

`layout`

`skills add`

`skills find`

`skills list`

`skills remove`

`screen capture`

`screen resolve`

`sdk install`

`sdk list`

`sdk remove`

`run`

`sdk update`

`update`

`-V, --version`