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 tạo ứng dụng cho Android hiệu quả hơn bằng cách sử dụng bất kỳ công cụ nào bạn chọn. Nền tảng 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 một đ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 và SDK Android
  • Tạo khung cho các dự án mới từ mẫu
  • Quản lý thiết bị ảo, cài đặt APK và kiểm tra trực tiếp màn hình thiết bị cũng như hệ thống phân cấp giao diện người dùng ngay từ thiết bị đầu cuối
  • Kết nối với các phiên bản Android Studio đang chạy để phân tích mã ngữ nghĩa, kết xuất bản xem trước Compose và tra cứu phiên bản phần phụ thuộc
  • Kiểm thử ứng dụng bằng tính năng Hành trình

Android CLI cũng cấp cho các 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 mà Android đề xuất.

Để xem nội dung mô tả đầy đủ về các lệnh và lựa chọn của Android CLI, hãy xem Tài liệu tham khảo về lệnh Android CLI.

Cài đặt Android CLI

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

  1. Tải Android CLI 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 android init để cài đặt kỹ năng android-cli.

Dữ liệu đã thu thập

Android CLI 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.

Để tắt tính năng thu thập dữ liệu, hãy dùng cờ --no-metrics khi chạy một lệnh bằng Android CLI.

Ý kiến phản hồi và báo cáo vấn đề

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, hãy báo cáo lỗi.

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.

Định cấu hình Android CLI

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, 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 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 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

-v, --verbose

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

Nội dung mô tả: Bật đầu ra chi tiết. Chỉ định nhiều lựa chọn -v để tăng độ chi tiết (ví dụ: -v, -vv hoặc -vvv).

-V, --version

Cách sử dụng: android -V

Nội dung mô tả: In thông tin phiên bản rồi thoát.

Lệnh

Để xem nội dung mô tả đầy đủ về các lệnh và lựa chọn của Android CLI, hãy xem Tài liệu tham khảo về lệnh Android CLI.