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 khi tạo bản dựng cho Android bằng bất kỳ công cụ nào bạn chọn. Nền tảng này tiêu 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ể tinh giản quy trình CI, bảo trì và mọi quy trình tự động hoá khác dựa trên kịch bản 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 để thực hiện các tác vụ như sau:

• Tự động hoá quy trình thiết lập môi trường
• Tạo khung cho các dự án mới từ mẫu
• Quản lý thiết bị ảo ngay trên thiết bị đầu cuối
• Kiểm thử ứng dụng bằng Hành trình

CLI Android cũng cho phép các tác nhân của bạn truy cập vào các kỹ năng của Android và Cơ sở kiến thức chuyên biệt của Android để đả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 mà Android đề xuất.

Cài đặt Android CLI

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

1. Tải CLI Android xuống.

2. Để đả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
   

Để 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 lệnh này trả về một đường dẫn, thì tức là Android CLI đã được cài đặt.

Thiết lập cho nhân viên hỗ trợ

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

android init

Dữ liệu đã thu thập

CLI Android thu thập dữ liệu về mức sử dụng cơ bản của công cụ này. Sau đây là dữ liệu mà chúng tôi thu thập:

• Các lệnh gọi của lệnh android và các lệnh phụ, ví dụ: android run và android create.
• Tên của các đối số hoặc lựa chọn không theo vị trí được sử dụng, ví dụ: --sdk hoặc --version.
• Các đối số vị trí và giá trị cờ liên kết với một tập hợp cố định, xác định trước các lựa chọn hệ thống do Android CLI quản lý. Ví dụ: chúng tôi thu thập tên mẫu trình mô phỏng, chẳng hạn như medium_phone và large_desktop, cũng như tên tác nhân, chẳng hạn như GEMINI, CLAUDE hoặc CODEX.
• Dấu vết ngăn xếp và thông báo ngoại lệ, trong đó thông tin nhận dạng được ẩn danh trước khi thu thập để đảm bảo quyền riêng tư.

Sau đây là một số ví dụ về dữ liệu mà chúng tôi không thu thập:

• Chúng tôi không thu thập phản hồi của CLI khi một lệnh được chạy.
• Chúng tôi không thu thập dữ liệu đầu vào do người dùng tạo hoặc các giá trị nhận dạng bên ngoài được truyền đến CLI, chẳng hạn như các toạ độ Maven cụ thể, đường dẫn tệp cục bộ hoặc tên dự án tuỳ chỉnh. Ví dụ: nếu lệnh android create --name=com.company.internal.app được thực thi, chúng ta sẽ ghi lại rằng android create đã được thực thi bằng đối số --name nhưng chúng ta không lưu trữ giá trị com.company.internal.app.

Vấn đề đã biết

• Lệnh android emulator cho Windows hiện đang bị vô hiệu hoá.
• Hiện tại, chúng tôi không hỗ trợ việc tải Android CLI xuống từ Windows PowerShell.

Nếu bạn gặp bất kỳ vấn đề nào hoặc muốn gửi ý kiến phản hồi, vui lòng báo cáo lỗi.

Định cấu hình CLI Android

Tạo tệp .androidrc để tự động áp dụng cờ và lựa chọn mỗi khi bạn gọi Android CLI. Lưu tệp ở vị trí sau đây, tuỳ thuộc vào hệ điều hành của bạn:

• macOS và Linux: ~/.androidrc
• Windows: %USERPROFILE%\.androidrc

Thêm các cờ bạn muốn tự động áp dụng cho tệp, mỗi cờ trên một dòng.

Ví dụ: để Android CLI sử dụng một SDK Android cụ thể theo mặc định mỗi lần, hãy thêm cờ --sdk vào tệp của bạn:

--sdk=<path-to-sdk>

Tuỳ chọn chung

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

-h, --help

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

Nội dung mô tả: Hiển thị tài liệu 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 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 biến môi trường chung mỗi khi muốn chuyển đổi. Để kiểm tra xem bạn đang dùng SDK Android nào 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 CLI Android và mô tả chức năng của các lệnh đó. Tất cả các lệnh này đều phải bắt đầu bằng android, ví dụ: android create, android run, v.v. Các hệ số điều chỉnh không bắt buộc được đặt trong dấu ngoặc vuông [], còn 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ẫu. Để xem các lựa chọn về 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 chức năng của các mẫu khác nhau trước khi cam kết sử dụng một mẫu.
• --verbose – Cho phép đầu ra chi tiết, bao gồm cả những 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 dùng để tạo dự án mới. Nếu bạn bỏ qua, empty-activity-agp-9 sẽ được 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 mô tả chi tiết cấu trúc của dự án, bao gồm cả cá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ủa các 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ỏ 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>

Mô tả: Lệnh android docs là một quy trình gồm hai bước để truy cập trực tiếp vào Cơ sở kiến thức Android từ CLI. Trước tiên, hãy tì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ể dùng các URL này với lệnh fetch để xuất các lệnh tài liệu ra 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 bước này, 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 hiện có.

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ị để bắt đầu (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>

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 dùng. Để thay đổi SDK Android được dùng, hãy sử dụng --sdk.

init

Cách sử dụng: android init

Mô tả: Thiết lập môi trường cho các 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 tế 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í lưu tệp để lưu cây bố cục. Nếu bị bỏ qua, JSON sẽ được in trực tiếp vào stdout.
• -d, --diff – Trả về danh sách chỉ gồm các phần tử 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

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. Thao tác này không thực hiện bất kỳ bước nào trong quá trình tạo bản dựng; bạn phải cung cấp(các) đường dẫn đến các tệp APK mà bạn muốn cài đặt.

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

• --apks – Danh sách đườ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 này 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 sẽ khởi chạy sau khi APK được cài đặt. 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 có nhiều thiết bị được kết nối. Để tìm số sê-ri của thiết bị, hãy chạy adb devices.
• --type – Loại thành phần để bắt đầu. Hãy sử dụng phương thức này nếu bạn muốn bắt đầu một dịch vụ nền ngay lập tức 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ụ 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ể.

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 được 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ị 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 phần tử 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ạ độ thực trên màn hình (x, y). Hữu ích cho việc viết kịch bản về các lượt nhấp vào các phần tử mà không cần phải 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 chứa ít nhất một phần giữ chỗ tương ứng với nhãn của phần tử trên giao diện người dùng theo đị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 ở toạ độ (500, 1000), thì lệnh

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

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ần cài đặt, được phân tách bằng dấu cách. Nếu bạn không chỉ định phiên bản, thì 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 beta.
• --canary – Bao gồm các gói thử nghiệm.
• --force – Buộc hạ cấp xuống một 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à Bộ công cụ bản 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.
• android sdk install --force platforms/android-33@1 – Quay lại 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ả phiên bản cho từng gói.
• --beta – Bao gồm các gói beta.
• --canary – Bao gồm các gói thử nghiệm.

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

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 gói nào, 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 beta.
• --canary – Bao gồm các gói thử nghiệm.
• --force – Buộc hạ cấp xuống một phiên bản cũ hơn.

Ví dụ:

• android sdk update – Kiểm tra và cài đặt bản cập nhật cho mọi thứ trong SDK.
• 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.

skills add

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

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

Nội dung mô tả: Cài đặt các kỹ năng Android vào 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. Nếu bạn đã cài đặt các kỹ năng Android, skills add sẽ cập nhật các kỹ năng đó lên phiên bản mới nhất.

Lựa chọn:

• --all – Cài đặt hoặc cập nhật 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), thì chỉ kỹ năng android-cli đượ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 hoặc cập nhậ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 hoặc cập nhật. Nếu bạn bỏ qua (và không chỉ định --all), thì chỉ kỹ năng android-cli mới được cài đặt hoặc cập nhật.

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

skills find

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

Mô tả: Tìm những kỹ năng khớp với một chuỗi cho trước.

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

• string – Chuỗi khớ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 hiện có.

Lựa chọn:

• --long – Đưa ra thông tin bổ sung cho từng kỹ năng, bao gồm cả nội dung mô tả về kỹ năng và những tác nhân đã cài đặt kỹ năng đó.

skills remove

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

Mô tả: Xoá một kỹ năng. Nếu bạn không chỉ định các tác nhân cụ thể, thì kỹ năng sẽ bị xoá đối với 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 mà bạn muốn xoá kỹ năng. Nếu bạn bỏ qua, kỹ năng này sẽ bị xoá đối với tất cả các nhân viên.

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

studio check

Các lệnh studio cho phép bạn hoặc tác nhân AI của bạn tương tác với các phiên bản đang hoạt động của Android Studio. Bằng cách kết nối với một phiên bản đang chạy, bạn có thể sử dụng các chức năng của IDE để phân tích tệp, tìm khai báo và cách sử dụng biểu tượng, kết xuất bản xem trước Compose và tra cứu các phiên bản phần phụ thuộc.

Cách sử dụng: android studio check

Nội dung mô tả: Kiểm tra trạng thái của các phiên bản Android Studio đang chạy và liệt kê các dự án đang mở. Trước tiên, hãy chạy lệnh này để xác minh mối kết nối giữa CLI và IDE, đồng thời chọn PID và dự án mà bạn muốn kết nối (nếu có nhiều dự án).

Ví dụ về kết quả đầu ra:

Nếu được kết nối, đầu ra sẽ liệt kê PID của phiên bản Android Studio đang chạy, phiên bản và trạng thái của các dự án đang mở:

pid: 32942
version: Android Studio Quail
Projects:
    READY     MyApplication /Users/username/AndroidStudioProjects/MyApplication

studio analyze-file

Cách sử dụng: android studio analyze-file [--pid=<pid>] [--project=<project>] <path>

Nội dung mô tả: Phân tích một tệp trong Android Studio để tìm lỗi, cảnh báo và lỗi mã nguồn bằng công cụ kiểm tra tích hợp của IDE.

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

• <path> – Đường dẫn đến tệp Kotlin hoặc Java cần phân tích.

Lựa chọn:

• --pid=<pid> – PID của phiên bản Android Studio cụ thể cần kết nối, nếu có nhiều phiên bản.
• --project=<project> – Tên của dự án mở trong Android Studio để truy vấn, nếu có nhiều dự án. Nếu bạn chạy lệnh analyze-file trong một thư mục dự án, thì dự án đó sẽ được dùng theo mặc định.

Ví dụ:

android studio analyze-file \
  --project=MyApplication \
  /Users/username/AndroidStudioProjects/MyApplication/app/src/main/java/com/example/myapp/MainActivity.kt

studio find-declaration

Cách sử dụng: android studio find-declaration [--short] [--context-file=<path>] [--pid=<pid>] [--project=<project>] <symbol>

Nội dung mô tả: Tìm vị trí khai báo chính xác của một biểu tượng (lớp, phương thức, biến, trường, hằng số hoặc tài nguyên Android) trong dự án bằng cách sử dụng độ phân giải ngữ nghĩa.

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

• <symbol> – Tên của biểu tượng mã để tìm khai báo.

Lựa chọn:

• --context-file=<path> – Đường dẫn không bắt buộc đến một tệp chứa thông tin tham chiếu đến biểu tượng. Việc cung cấp một tệp ngữ cảnh sẽ giúp giải quyết các biểu tượng mơ hồ hoặc quá tải bằng cách cung cấp các nội dung nhập và phạm vi.
• --short – Đơn giản hoá đầu ra để chỉ hiển thị vị trí tệp và dòng trùng khớp.
• --pid=<pid> – PID của phiên bản Android Studio cụ thể cần kết nối, nếu có nhiều phiên bản.
• --project=<project> – Tên của dự án mở trong Android Studio để truy vấn, nếu có nhiều dự án. Nếu bạn chạy lệnh find-declaration trong một thư mục dự án, thì dự án đó sẽ được dùng theo mặc định.

Ví dụ:

android studio find-declaration --short HotelDetailScreen

studio find-usages

Cách sử dụng: android studio find-usages [--short] [--pid=<pid>] [--project=<project>] <symbol>

Nội dung mô tả: Tìm tất cả các lượt tham chiếu và sử dụng một biểu tượng trong toàn bộ dự án bằng cách sử dụng phân tích ngữ nghĩa.

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

• <symbol> – Tên của biểu tượng cần tìm cách sử dụng.

Lựa chọn:

• --short – Đơn giản hoá đầu ra để chỉ hiển thị các vị trí tệp phù hợp.
• --pid=<pid> – PID của phiên bản Android Studio cụ thể cần kết nối, nếu có nhiều phiên bản.
• --project=<project> – Tên của dự án mở trong Android Studio để truy vấn, nếu có nhiều dự án. Nếu bạn chạy lệnh này trong thư mục dự án, thì dự án đó sẽ được dùng theo mặc định.

Ví dụ:

android studio find-usages --short HotelDetailScreen

studio open-file

Cách sử dụng: android studio open-file [--pid=<pid>] [--project=<project>] <path>

Nội dung mô tả: Mở một tệp ngay trong cửa sổ trình chỉnh sửa đang hoạt động của Android Studio.

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

• <path> – Đường dẫn của tệp cần mở. Có thể được chỉ định tương ứng với thư mục gốc của dự án hoặc dưới dạng đường dẫn tuyệt đối.

Lựa chọn:

• --pid=<pid> – PID của phiên bản Android Studio cụ thể cần kết nối, nếu có nhiều phiên bản.
• --project=<project> – Tên của dự án mở trong Android Studio để truy vấn, nếu có nhiều dự án. Nếu bạn chạy lệnh open-file trong thư mục dự án, thì dự án đó sẽ được dùng theo mặc định.

Ví dụ:

android studio open-file app/src/main/java/com/example/myapp/ui/DetailScreen.kt

studio render-compose-preview

Cách sử dụng: android studio render-compose-preview [--print-semantics] [--output-image-file=<filename>] [--pid=<pid>] [--project=<project>] <path> <composable>

Nội dung mô tả: Kết xuất bản xem trước giao diện người dùng Jetpack Compose và tuỳ ý trả về cây ngữ nghĩa bố cục của bản xem trước đó. Điều này rất hữu ích cho việc kiểm thử trực quan hoặc cho phép các tác nhân AI hoạt động với bố cục của giao diện người dùng.

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

• <path> – Đường dẫn đến tệp Kotlin chứa bản xem trước Compose.
• <composable> – Tên của hàm xem trước có khả năng kết hợp (được đánh dấu bằng @Preview).

Lựa chọn:

• --output-image-file=<filename> – Chỉ định tên tệp để ghi hình ảnh PNG được kết xuất thu được. Nếu bạn bỏ qua, một tệp tạm thời sẽ được tạo.
• --print-semantics – Nếu đúng, sẽ in cây ngữ nghĩa hỗ trợ tiếp cận của bản xem trước Compose đã kết xuất ở định dạng JSON. Điều này cho phép các tác nhân phân tích cấu trúc và các phần tử tương tác của giao diện người dùng.
• --pid=<pid> – PID của phiên bản Android Studio cụ thể cần kết nối, nếu có nhiều phiên bản.
• --project=<project> – Tên của dự án mở trong Android Studio để truy vấn, nếu có nhiều dự án. Nếu bạn chạy lệnh render-compose-preview trong một thư mục dự án, thì dự án đó sẽ được dùng theo mặc định.

Ví dụ:

android studio render-compose-preview \
  --output-image-file=preview_hotel.png \
  --print-semantics \
  app/src/main/java/com/example/myapp/ui/DetailScreen.kt \
  HotelDetailScreenPreview

studio version-lookup

Cách sử dụng: android studio version-lookup [--pid=<pid>] [--project=<project>] <artifacts...>

Nội dung mô tả: Tra cứu các phiên bản mới nhất hiện có của các phần phụ thuộc phổ biến, nền tảng Android và công cụ SDK trong các kho lưu trữ như Google Maven. Điều này cung cấp một giải pháp thay thế có lập trình cho việc kiểm tra phiên bản phần phụ thuộc theo cách thủ công.

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

• <artifacts...> – Danh sách giá trị nhận dạng được phân tách bằng dấu cách. Bạn có thể truy vấn nhiều cấu phần phần mềm trong một lệnh duy nhất. Các giá trị nhận dạng được hỗ trợ bao gồm:
  • Thư viện Maven: Ký hiệu groupId:artifactId (ví dụ: androidx.window:window).
  • Trình bổ trợ Gradle: Mã trình bổ trợ (ví dụ: com.android.application).
  • Từ khoá:
    • gradle (Công cụ tạo bản dựng Gradle)
    • studio (Android Studio)
    • agp (Trình bổ trợ Android cho Gradle)
    • ndk (Android NDK)
    • sdk (Android SDK)
    • emulator (Trình mô phỏng Android)
    • adb (Cầu gỡ lỗi Android)
    • compose (BOM Jetpack Compose)
    • kotlin (Trình biên dịch và thời gian chạy Kotlin)
    • android (Phiên bản hệ điều hành Android)
    • platform-tools (Android SDK Platform-Tools)
    • cmdline-tools (Bộ công cụ dòng lệnh SDK Android)
    • build-tools (Công cụ xây dựng SDK Android)

Lựa chọn:

• --pid=<pid> – PID của phiên bản Android Studio cụ thể cần kết nối, nếu có nhiều phiên bản.
• --project=<project> – Tên của dự án mở trong Android Studio để truy vấn, nếu có nhiều dự án. Nếu bạn chạy lệnh version-lookup trong một thư mục dự án, thì dự án đó sẽ được dùng theo mặc định.

Ví dụ:

android studio version-lookup \
  androidx.compose.ui:ui \
  com.android.application \
  agp \
  kotlin

update

Cách sử dụng: android update

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

-V, --version

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