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 xây dựng ứng dụng cho Android hiệu quả hơn bằng bất kỳ công cụ nào bạn chọn. Chứng chỉ 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 bắt đầu cho 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á CI, hoạt động bảo trì và mọi hoạt động tự động hoá theo tập lệnh khác cho tính chất ngày càng phân tán của hoạt động phát triển Android.

Android CLI bao gồm toàn bộ vòng đời phát triển, từ việc tạo dự án và thử nghiệm dự án trên thiết bị cho đến việc phân tích hiệu suất và điều tra cách dự án hoạt động trong thực tế. 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:

Android CLI cũng cung cấp cho các tác nhân quyền truy cập vào kỹ năng Android và Cơ sở kiến thức Android chuyên biệt để đả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à tuỳ 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 lệnh 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 tác nhân

Để giúp các tác nhân 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:

  • Lệnh gọi 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 tuỳ 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 nhóm tuỳ chọn hệ thống cố định, được xác định trước do Android CLI quản lý. Ví dụ: chúng tôi thu thập tên mẫu trình mô phỏng như medium_phone và large_desktop, cũng như tên tác nhâ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ư.

Dưới đâ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 thông tin đầu vào do người dùng tạo hoặc giá trị nhận dạng bên ngoài được truyền đến CLI, chẳng hạn như 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 tôi sẽ ghi lại rằng android create đã được thực thi bằng đối số --name nhưng chúng tôi 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 sử 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 đưa ra ý kiến phản hồi, hãy báo cáo lỗi.

Định cấu hình Android CLI

Tạo tệp .androidrc để tự động áp dụng cờ và tuỳ chọn mỗi khi bạn gọi Android CLI. Lưu tệp vào 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 luôn sử dụng một SDK Android cụ thể theo mặc định, 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ể 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 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 bạn muốn chuyển đổi. Để kiểm tra xem bạn đang sử dụng SDK Android nào theo mặc định, hãy chạy lệnh 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 kết quả chi tiết. Chỉ định nhiều tuỳ chọn -v để tăng độ chi tiết (ví dụ: -v, -vv hoặc -vvv).

-V, --version

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

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à tuỳ chọn của Android CLI, hãy xem Tài liệu tham khảo về lệnh Android CLI.