Ghi chú phát hành cho Android CLI

Android CLI là giao diện chính để phát triển Android từ thiết bị đầu cuối, được xây dựng để hỗ trợ quy trình phát triển của bạn bằng cách sử dụng tác nhân và công cụ mà bạn chọn.

Trang này liệt kê các tính năng mới trong mỗi bản phát hành Android CLI. Để tải Android CLI xuống, hãy truy cập vào trang tải xuống. Để tìm hiểu thêm, hãy xem bài viết Tổng quan về Android CLI.

Phiên bản 1.1.16919734 (Tháng 11 năm 2026)

  • Cài đặt delta sử dụng lại các tệp đã định vị lại: android install và android run không còn gửi lại các tệp không thay đổi có vị trí trong APK đã thay đổi. Để tắt, hãy truyền --use-delta-install-instructions=COPY,DATA.
  • Theo dõi Compose: android profiler systemtrace có thể ghi lại những gì Jetpack Compose thực hiện trong một ứng dụng. Truyền --enable=compose.composition để ghi lại một lát cắt cho mỗi hàm composable chạy hoặc --enable=compose.recomposition để ghi lại các lượt đọc và ghi state gây ra quá trình recomposition lại. Ứng dụng này cần có androidx.compose.runtime:runtime-tracing 1.13 trở lên. Dấu vết được lưu dưới dạng tệp lưu trữ ZIP mà bạn mở trong trình phân tích tài nguyên của Android Studio.
  • Tệp báo lỗi khối xếp Perfetto: Truyền --type=perfetto đến android profiler heapdump capture để ghi lại tệp báo lỗi khối xếp dưới dạng dấu vết Perfetto. Tệp này có các đối tượng và tệp đối chiếu giữa các đối tượng, nhưng không có giá trị của các đối tượng đó, vì vậy, tệp này nhỏ hơn tệp .hprof. Công cụ này yêu cầu Android 12 (API cấp 31) trở lên và một ứng dụng có thể phân tích tài nguyên hoặc có thể gỡ lỗi.
  • Định dạng kích thước DEX của thư viện trong tệp JSON phân tích: Trong kết quả đầu ra android analyze --format=json cho cấu phần phần mềm thư viện (AAR và JAR), các trường dexSizeBytes trong d8CompileResult và r8CompileResult hiện là số nguyên 64 bit được chuyển đổi tuần tự dưới dạng chuỗi thay vì số.
  • Kết quả đầu vào dưới dạng JSON: Các lệnh phụ android input in kết quả dưới dạng đối tượng JSON có danh sách results trên đầu ra chuẩn, ở cùng một định dạng cho mọi lệnh phụ. Các lỗi như không có phần tử nào khớp hoặc có nhiều phần tử khớp sẽ được báo cáo trong trường status của mỗi kết quả thay vì dưới dạng văn bản về sai số chuẩn.
  • Mã thoát của trình mô phỏng: android emulator create, start, stop và remove hiện thoát bằng mã khác 0 khi không thành công và in lỗi thành sai số chuẩn.

Phiên bản 1.1.16717390 (Tháng 10 năm 2026)

  • Tín hiệu sự cố thực tế: Sử dụng lệnh android signals mới để điều tra hành vi của ứng dụng trong thực tế bằng Firebase Crashlytics. Sau khi đăng nhập bằng android auth login, hãy tìm các dự án và ứng dụng của bạn bằng android signals context, sau đó liệt kê, lọc và phân tích sự cố, lỗi ANR và các vấn đề không nghiêm trọng bằng android signals crashes list, facets, describe và samples.
  • Tệp báo lỗi vùng nhớ khối xếp: Sử dụng android signals heaps để liệt kê, mô tả và tải xuống các tệp báo lỗi mà Crashlytics thu thập được về sự cố hết bộ nhớ và sự cố tắt do giới hạn bộ nhớ, cùng với siêu dữ liệu, khoá tuỳ chỉnh và nhật ký của phiên tạo ra các tệp báo lỗi đó.
  • Phân tích ứng dụng: Sử dụng lệnh android profiler mới để ghi lại dấu vết hệ thống bằng android profiler systemtrace và thu thập tệp báo lỗi vùng nhớ khối xếp JVM bằng android profiler heapdump capture trên thiết bị thông minh hoặc trình mô phỏng đã kết nối. Quản lý các phiên lập hồ sơ bằng android profiler session list, status và terminate.
  • Phân tích cấu phần phần mềm: Sử dụng lệnh android analyze mới để kiểm tra một hoặc nhiều tệp APK, AAB, AAR và JAR, đồng thời báo cáo thông tin chi tiết về gói, kích thước DEX, chỉ số tối ưu hoá và rút gọn R8, cũng như cảnh báo về quy tắc giữ lại thư viện và mức độ tối ưu hoá thấp. Truyền --format=json hoặc --format=textproto để có kết quả có thể đọc được bằng máy.
  • Bản xem trước Compose: Sử dụng lệnh android preview list mới để tìm các hàm @Preview của Jetpack Compose trong một mục tiêu và android preview render --fqn <name> để kết xuất các hàm đó thành hình ảnh PNG và tệp JSON của cây thành phần trên máy của bạn mà không cần Android Studio. Truyền --output để chọn nơi ghi tệp.
  • Tạo tệp đối chiếu trong quá trình chạy và cài đặt: android run và android install chấp nhận tệp đối chiếu bản dựng theo vị trí để tạo và triển khai một mục tiêu cụ thể. Các mục tiêu Gradle không có biến thể, chẳng hạn như :app, hiện mặc định là biến thể debug.
  • Cửa sổ phản chiếu thiết bị: Sử dụng lệnh android device hub mới để mở cửa sổ kiểu máy tính nhằm phản chiếu màn hình theo thời gian thực và điều khiển tương tác các thiết bị Android thực đã kết nối (bao gồm cả thiết bị từ xa được kết nối thông qua android device remote connect) và Trình mô phỏng Android.

Phiên bản 1.0.16625370 (tháng 10 năm 2026)

  • Tương tác với giao diện người dùng: Sử dụng lệnh android input mới để nhấn, cuộn, vuốt, nhập văn bản và nhấn phím trên thiết bị thông minh hoặc trình mô phỏng đã kết nối. Nhắm đến các phần tử trên giao diện người dùng bằng bộ chọn như text=Submit hoặc id=email,class=EditText, đồng thời kết hợp với android layout để tìm các phần tử cần tương tác.

Phiên bản 1.0.16500706 (Tháng 10 năm 2026)

  • Kết nối khi đặt trước: android device remote create hiện tự động kết nối yêu cầu đặt trước mới với adb. Chuyển --connect=false để chỉ tạo lượt đặt trước và kết nối sau bằng android device remote connect.

Phiên bản 1.0.16457483 (Tháng 9 năm 2026)

  • Đăng nhập vào các dịch vụ của Google: Với android auth login Android CLI, hãy đăng nhập vào Tài khoản Google của bạn để có thể gọi các dịch vụ của Google yêu cầu xác thực.
  • Danh mục thiết bị từ xa: Tìm các dự án trên đám mây của Google mà bạn có thể truyền trực tuyến thiết bị bằng android device remote projects và duyệt qua các thiết bị thực có sẵn bằng android device remote models.
  • Đặt trước thiết bị từ xa: Đặt trước một thiết bị thực từ xa bằng android device remote create, sau đó quản lý các lượt đặt trước bằng list, extend --duration <minutes> và remove.
  • Kết nối với thiết bị từ xa: Sử dụng android device remote connect để kết nối một thiết bị đã đặt trước với adb thông qua kết nối nền, nhờ đó thiết bị này hoạt động với android run, android install và các lệnh khác của thiết bị như một thiết bị cục bộ. Hãy dùng android device remote disconnect để tách.

Phiên bản 1.0.16406183 (Tháng 9 năm 2026)

  • Khởi động nhanh hơn: Android CLI khởi động nhanh hơn khoảng hai lần vì thư viện trình tải xuống gốc chỉ được tải khi được sử dụng và không còn được giải nén vào thư mục tạm thời trong mỗi lần gọi.
  • Mã thoát cố định: Các lệnh hiện trả về mã thoát khác 0 khi không thành công, bao gồm create, run, install, describe, layout, docs, info, skills và update, giúp việc viết tập lệnh và CI trở nên đáng tin cậy hơn.
  • Điều chỉnh chú thích trên màn hình: android screen --annotate hiển thị các tham số điều chỉnh để phát hiện tính năng, bao gồm cả ngưỡng phát hiện cạnh, lọc hình dạng và chiến lược phân cụm, được ghi lại trong --help.
  • Tuỳ chọn tạo dự án: android create hỗ trợ các cờ --application-id và --namespace cũng như tên tuỳ chọn có dấu gạch nối, chẳng hạn như --min-sdk. Mẫu Compose hiện sử dụng một nhóm tài nguyên src/main/kotlin và giao diện Material 3.
  • Trình mô phỏng không có giao diện người dùng: Khởi động trình mô phỏng không có cửa sổ bằng cách sử dụng android emulator start --headless.
  • Độ tin cậy của SDK: Các lệnh android sdk sử dụng khoá liên quy trình để các lệnh gọi đồng thời không xung đột, xác minh đường dẫn và phiên bản của các gói đã cài đặt, chỉ cập nhật tệp XML cũ khi cần và báo cáo lỗi rõ ràng hơn.
  • Kết quả xem trước của Compose: android studio render-compose-preview in đường dẫn tuyệt đối của hình ảnh được kết xuất và xác nhận việc ghi ngay cả khi sử dụng --print-semantics.
  • Hỗ trợ cấp độ API cũ hơn: Khắc phục lỗi tương tác với thiết bị, chẳng hạn như android layout, trên các thiết bị chạy API cấp 32 trở xuống.

Phiên bản 1.0.16261425 (Tháng 9 năm 2026)

  • Sửa lỗi bố cục: Khắc phục vấn đề lệnh bố cục không hoạt động trong một số trường hợp. Để tạm thời chuyển về hành vi bố cục cũ, hãy export ANDROID_CLI_LAYOUT_V1=1.

Phiên bản 1.0.16251017 (Tháng 9 năm 2026)

  • Kết xuất bố cục: android layout hiện hỗ trợ cờ --no-idle để tìm nạp bố cục mà không cần chờ trạng thái rảnh. android layout cũng hỗ trợ cờ --full để trả về toàn bộ cây bố cục mà không cần lọc; theo mặc định, layout chỉ trả về các thành phần tương tác.
  • Hoàn thành shell: Tạo và cài đặt tập lệnh tự động hoàn thành shell cho Bash và Zsh bằng lệnh android completion mới.
  • Cập nhật kỹ năng: Luôn cập nhật kỹ năng bằng lệnh android skills update mới, đồng thời cài đặt hoặc xoá nhiều kỹ năng trong một lệnh gọi (ví dụ: android skills install <skill1> <skill2>).
  • Liệt kê kỹ năng theo tác nhân: android skills list hiện mặc định hiển thị chi tiết, bao gồm cả nội dung mô tả kỹ năng và các tác nhân đã cài đặt kỹ năng đó. android skills list cũng hỗ trợ cờ --agent <agent> để liệt kê tất cả kỹ năng được cài đặt cho một nhân viên hỗ trợ.
  • Hiệu suất cài đặt Delta: Tăng tốc độ vá APK gia tăng trong android install bằng cách sử dụng lệnh gọi hệ thống hạt nhân không sao chép.
  • Phát hiện cạnh màn hình: Cải thiện tính năng và phát hiện cạnh trong android screen bằng thuật toán phát hiện cạnh Canny.

Phiên bản 1.0.15985488 (Tháng 7 năm 2026)

  • Lệnh cài đặt chuyên dụng: Cài đặt tệp APK bằng lệnh android install độc lập có tính năng đẩy tệp APK gia tăng, giúp cho các đơn đặt hàng cài đặt gia tăng nhanh hơn nhiều so với adb.
  • Chạy cài đặt gia tăng: Tương tự, hãy sử dụng cờ --use-delta-install mới trong android run để triển khai APK gia tăng nhanh hơn cho thiết bị.
  • Quản lý SDK đa nền tảng: Nhắm đến các nền tảng không phải máy chủ bằng cờ --platform <os_arch> mới trong các lệnh android sdk (install, update, materialize) để kiểm tra, giải quyết và cài đặt các thành phần trên các kiến trúc hệ điều hành và CPU.
  • Cải tiến CLI kỹ năng: Mở rộng các lệnh phụ android skills (add, remove, list, find) bằng tài liệu --help, phản hồi rõ ràng khi thiếu kỹ năng và giai đoạn tải xuống nguyên tử an toàn hơn với tính năng khôi phục tự động.

Phiên bản 1.0.15857036 (Tháng 7 năm 2026)

  • Hỗ trợ nhiều kỹ năng hơn cho tác nhân: Cài đặt kỹ năng trên hàng chục môi trường tác nhân (bao gồm Claude Code, Cursor, Cline, OpenHands, Windsurf, Zed và Devin) bằng android skills install.
  • Trình tải xuống gốc có hỗ trợ proxy: Tải tài nguyên mạng xuống một cách đáng tin cậy bằng trình tải xuống HTTP gốc có hỗ trợ sẵn cho proxy của công ty.
  • Quản lý gói SDK: Quản lý gói SDK bằng tính năng xoá nhiều gói trong android sdk remove và phân giải dựa trên SHA trong android sdk resolve.
  • Cải tiến về mô tả và màn hình: Xem lỗi bản dựng Gradle ngay trên đầu ra chuẩn trong android describe và nhắm đến các thiết bị cụ thể bằng cờ --device trong android screen.
  • Khả năng hữu dụng của CLI và Error Reporting: Thông báo lỗi rõ ràng hơn khi nhập các lệnh không xác định hoặc mục tiêu tạo dự án không hợp lệ, các lệnh android emulator không phân biệt chữ hoa chữ thường.

Phiên bản 1.0.15498356 (Tháng 5 năm 2026)

  • Tải mẫu SDK động: Các mẫu dự án cho android create hiện được tải xuống một cách linh động từ gói SDK Android thay vì được đóng gói trong tệp nhị phân CLI, đảm bảo các dự án mới luôn sử dụng mẫu mới nhất.
  • Khả năng tương thích của giấy phép SDK: Giấy phép SDK được chấp nhận do android sdk lưu hiện khớp với định dạng tệp mà các công cụ SDK Android và trình bổ trợ Gradle cũ hơn yêu cầu.
  • Hỗ trợ đường liên kết tượng trưng: Thêm tính năng hỗ trợ cho các đường liên kết tượng trưng trên các lệnh CLI và thao tác với tệp.
  • Trích xuất tệp nhị phân nguyên tử: Ngăn chặn tình huống tương tranh trích xuất trong các lệnh gọi CLI đa quy trình đồng thời bằng cách giải nén tệp nhị phân vào một thư mục tạm thời trước khi di chuyển chúng vào vị trí một cách nguyên tử.
  • Tính ổn định của Windows: Cải thiện khả năng tương thích và hiệu suất của Windows trên Windows 11, đồng thời khắc phục các vấn đề về phân giải đường dẫn thư mục gốc.

Phiên bản 1.0.15433482 (Tháng 5 năm 2026)

  • Tích hợp Antigravity: Android CLI và các kỹ năng hiện đã được tích hợp chính thức vào Google Antigravity 2.0 dưới dạng một gói tài nguyên không bắt buộc để đơn giản hoá quy trình phát triển tác nhân.
  • Lệnh Android Studio: Sử dụng lệnh android studio mới để cho phép tác nhân tận dụng các chức năng chuyên sâu, theo bối cảnh của Android Studio, bao gồm cả phân tích mã, tra cứu ngữ nghĩa và kết xuất Compose.
  • Hỗ trợ Hành trình: Xác thực trải nghiệm quan trọng của người dùng bằng Hành trình, tức là nội dung mô tả bằng ngôn ngữ tự nhiên về luồng người dùng mà tác nhân của bạn có thể chạy từ thiết bị đầu cuối hoặc trong CI/CD.
  • Kỹ năng mới về Android: Sử dụng thư viện kỹ năng mới về Android, bao gồm cả các kỹ năng di chuyển CameraX, giao diện người dùng thích ứng, AppFunctions và Kiểu Compose.
  • Các lựa chọn cài đặt khác: Cài đặt và cập nhật Android CLI bằng các trình quản lý gói phổ biến, bao gồm apt-get, winget và homebrew. Để biết thông tin chi tiết, hãy xem các lựa chọn tải xuống.

Phiên bản 0.7 (Tháng 4 năm 2026)

Bản phát hành đầu tiên!