Trạm kiểm tra Android

Trạm kiểm tra Android là một công cụ kiểm tra mà các nhà phát triển và kỹ sư kiểm tra Android có thể sử dụng để sử dụng giao diện người dùng để chạy các bộ kiểm tra Android tiêu chuẩn, chẳng hạn như Bộ kiểm tra tương thích Android (CTS) . Công cụ này hoạt động như một giao diện web cho Liên đoàn Thương mại (TF) , cho phép bạn dễ dàng chạy CTS trên một bộ thiết bị thử nghiệm với thiết lập tối thiểu, cũng như thiết lập lịch để chạy thử nghiệm liên tục.

Thiết lập trạm thử nghiệm Android

Phần này giải thích cách cài đặt và thiết lập Android Test Station.

Trạm kiểm tra Android sử dụng mã nguồn từ các vị trí sau:

• Mã nguồn Trạm thử nghiệm Android
• Mã nguồn cụm TradeFed

Cài đặt trạm thử nghiệm Android

Tuân theo mọi yêu cầu về phần cứng và phần mềm đối với bộ thử nghiệm bạn chạy.

Các yêu cầu đối với CTS được tìm thấy trên source.android.com .

Không có yêu cầu phần cứng bổ sung nào cho ATS nhưng chúng tôi khuyên bạn nên sử dụng yêu cầu về máy chủ CTS làm điểm bắt đầu.

Có hai cách để cài đặt Android Test Station:

• Chạy chương trình cài đặt .
• Cài đặt thủ công , yêu cầu cài đặt nhiều chương trình và tài nguyên.

Cài đặt bằng chương trình cài đặt

Trên Ubuntu 20.04+, chương trình cài đặt sẽ cài đặt và định cấu hình tất cả các chương trình cũng như tài nguyên cần thiết để chạy Trạm thử nghiệm Android.

Để sử dụng chương trình cài đặt:

1. Chạy chương trình cài đặt:

   curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
   

2. Chạy mtt version để kiểm tra phiên bản đã cài đặt của Android Test Station CLI.

Cài đặt thủ công

Cài đặt Docker

1. Làm theo hướng dẫn để cài đặt Docker Community Edition (CE) trên máy Linux của bạn.

2. Thực hiện theo các bước sau khi cài đặt để quản lý Docker với tư cách người dùng không phải root .

3. Bạn có thể cần phải khởi động lại cửa sổ terminal hoặc đăng xuất và đăng nhập lại để các thay đổi về quyền có hiệu lực.

Cài đặt Python 3

Trạm kiểm tra Android CLI được xác minh dựa trên Python phiên bản 3.7 đến 3.10.

Đối với Ubuntu 16.04 trở về trước, trước tiên hãy thêm kho lưu trữ cho Python 3 bằng cách thực hiện một trong các thao tác sau:

• Chạy lệnh này:

  sudo add-apt-repository ppa:deadsnakes/ppa
  

• Xây dựng và cài đặt kho lưu trữ từ nguồn .

Để cài đặt Python 3, hãy chạy các lệnh sau:

sudo apt-get update
sudo apt install python3 python3-distutils

Để cài đặt một phiên bản Python 3 cụ thể (ví dụ: 3.10), hãy chạy các lệnh sau:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

Tải Trạm thử nghiệm Android CLI

Tải xuống gói giao diện dòng lệnh (CLI) tại đây.

Khởi động trạm thử nghiệm Android

Khởi động Trạm thử nghiệm Android bằng lệnh sau:

mtt start

Lần đầu tiên giao diện người dùng được khởi động, có thể mất vài phút để giao diện này xuất hiện. CLI hiển thị URL web để truy cập giao diện người dùng trong trình duyệt. Theo mặc định, URL web là localhost:8000 . Nếu cần, bạn có thể thay đổi cổng mặc định khi khởi động bằng cờ --port .

Nếu có phiên bản mới hơn, bạn có thể cập nhật lên phiên bản hiện tại. Bạn có thể kiểm tra Ghi chú phát hành để biết các bản phát hành mới nhất.

Để cập nhật lên phiên bản hiện tại, hãy chạy:

mtt start --force_update

Để dừng ứng dụng, hãy chạy:

mtt stop

Để xem danh sách các lệnh khác, hãy sử dụng:

mtt --help

Sao lưu và khôi phục cơ sở dữ liệu

Để sao lưu cơ sở dữ liệu ATS, hãy dừng ứng dụng và chạy lệnh sau để sao lưu cơ sở dữ liệu hiện tại vào tệp TAR có tên mtt-backup.tar trong thư mục chính của bạn:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

Để khôi phục, hãy chạy lệnh sau trước khi khởi động ứng dụng:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

Trình hướng dẫn cài đặt

Sau khi bạn cài đặt và chạy Android Test Station lần đầu tiên, Trình hướng dẫn thiết lập sẽ hướng dẫn bạn qua một số bước để giúp bạn tùy chỉnh công cụ cho môi trường của mình. Mọi thay đổi bạn thực hiện ở đây có thể được cấu hình lại sau thông qua trang Cài đặt.

Khôi phục bản sao lưu cấu hình

Nếu bạn có tệp cấu hình được sao lưu từ máy chủ Trạm kiểm tra Android khác, bạn có thể tải tệp lên để sao chép mọi cấu hình được sửa đổi từ máy chủ đó bằng cách nhấp vào nút Tải tệp lên .

Hình 1. Khôi phục bản sao lưu cấu hình.

Đặt tài khoản dịch vụ mặc định

Bạn có thể đặt tài khoản dịch vụ mà Android Test Station sử dụng theo mặc định khi truy cập vào tài nguyên của mình (ví dụ: Google Cloud Storage, Google Drive). Để xác thực tài khoản dịch vụ của bạn, hãy nhấp vào Tải lên khóa tài khoản dịch vụ và chọn tệp khóa JSON của tài khoản dịch vụ của bạn.

Hình 2. Thiết lập tài khoản dịch vụ.

Khi tài khoản dịch vụ được xác thực thành công, địa chỉ email của tài khoản sẽ xuất hiện ở góc trên cùng bên phải của trang. Để thay đổi tài khoản dịch vụ, hãy nhấp vào tên tài khoản, xóa tài khoản mặc định hiện tại và tải khóa tài khoản dịch vụ mới lên.

Hình 3. Thay đổi tài khoản dịch vụ.

Nhập bộ cấu hình

Bộ cấu hình là một nhóm cấu hình để chạy bộ thử nghiệm, bao gồm các hành động liên quan đến thiết bị và kênh xây dựng. Bộ cấu hình được lưu trữ trong nhóm Google Cloud Storage (GCS) cụ thể. Sau khi xác thực kênh xây dựng GCS bằng tài khoản Google của bạn, bạn sẽ thấy danh sách tất cả các bộ cấu hình có sẵn cho bạn.

Chọn bất kỳ bộ cấu hình nào bạn muốn thêm vào máy chủ Trạm kiểm tra của mình và nhấp vào Nhập đã chọn .

Hình 4. Nhập Bộ cấu hình.

Bao gồm cài đặt Wi-Fi

Một số thử nghiệm CTS yêu cầu thiết bị của bạn kết nối với điểm phát sóng Wi-Fi. Để chọn mạng Wi-Fi của bạn, hãy nhập WiFi SSID và WiFi PSK tùy chọn.

Hình 5. Cài đặt điểm phát sóng Wi-Fi.

Sau khi hoàn thành Trình hướng dẫn cài đặt, trang sẽ tải lại với các cài đặt mới được áp dụng.

Kết nối một thiết bị

Gỡ lỗi USB phải được bật để sử dụng thiết bị để kiểm tra. Để bật gỡ lỗi:

1. Làm theo hướng dẫn trong Bật tùy chọn nhà phát triển và gỡ lỗi .

2. Nếu bạn dự định sử dụng các bản dựng Android thử nghiệm được tải sẵn các khóa ADB tùy chỉnh, hãy đặt các tệp .adb_key tùy chỉnh trong thư mục ~/.android/ .

   Các tệp được tải tự động và chuyển tới ADB để tự động bật gỡ lỗi USB sau khi thiết bị được flash cho các thiết bị chạy các bản dựng đó.

3. Kết nối thiết bị với máy chủ bằng USB.

   Thiết bị xuất hiện trong tab Thiết bị trạm kiểm tra Android trong vòng một phút sau khi làm mới giao diện web. Bạn cũng có thể xem trạng thái của thiết bị trên tab này.

   

   Hình 6. Kết nối thiết bị.

Các trạng thái thiết bị khác nhau là:

• Có sẵn - Thiết bị đã được kết nối và sẵn sàng chạy thử nghiệm.
• Đã phân bổ - Thiết bị đã được kết nối và hiện đang chạy thử nghiệm. Mỗi thiết bị chỉ có thể chạy một bài kiểm tra tại một thời điểm, vì vậy thiết bị phải hoàn thành bài kiểm tra hiện tại trước khi chạy bài kiểm tra mới.

Chạy thử nghiệm

Chọn một bài kiểm tra

Trạm thử nghiệm Android đi kèm với một bộ cấu hình CTS được đóng gói sẵn. Để chạy một trong những thử nghiệm này, hãy chuyển đến tab Bộ thử nghiệm và nhấp vào Chạy thử nghiệm cho thử nghiệm mong muốn.

Hình 7. Chọn bài kiểm tra.

Để chỉnh sửa hoặc thêm bài kiểm tra mới, hãy xem Thêm bài kiểm tra .

Cấu hình chạy thử

Chỉnh sửa các tham số để sử dụng cho lần chạy thử nghiệm cụ thể này. Hầu hết các tham số đều được điền sẵn các giá trị được xác định trong cấu hình thử nghiệm đã chọn.

Bước này có thể được hoàn thành bằng cách sử dụng các giá trị mặc định, nhưng bạn có thể thay đổi bất kỳ tham số nào, chẳng hạn như Max Retry và Command , để phù hợp với nhu cầu của bạn.

Hình 8. Cấu hình chạy thử.

Các thông số chạy thử nghiệm là:

• Tên - Tên của bộ thử nghiệm bạn muốn chạy.
• Số lần chạy - Số lần chạy thử nghiệm này sẽ được thực hiện khi được lên lịch. Các lần chạy thử nghiệm được lên lịch bằng cách sử dụng Liên đoàn Thương mại , chạy song song tối đa 20 lần chạy thử nghiệm nếu có khả năng thực hiện.
• Thử lại tối đa - Số lần tối đa để thử lại lần chạy thử nếu ít nhất một lần thử nghiệm không thành công. Điều này thường được đặt thành 4–6 lần thử lại cho một lần chạy CTS đầy đủ nhằm xử lý các thử nghiệm không ổn định.
• Hết thời gian xếp hàng - Nếu quá trình chạy thử nghiệm vẫn ở trạng thái Đã xếp hàng quá lâu thì quá trình chạy thử nghiệm đó sẽ tự động bị hủy. Chỉ định khoảng thời gian chờ đợi trước khi hủy tại đây. Mặc định là 24 giờ.

• Lệnh - Lệnh chạy bộ thử nghiệm. Bạn có thể nhập các đối số dòng lệnh bổ sung tại đây. Ví dụ: chạy một mô-đun cụ thể trong CTS 8.1 với:

  cts-suite -m ShortModuleName
  

• Lệnh thử lại - Lệnh thử lại một bộ thử nghiệm. Bạn có thể thêm các đối số dòng lệnh bổ sung tại đây. Ví dụ: để chỉ thử lại một mô-đun cụ thể trong CTS 8.1, hãy sử dụng:

  cts --retry 0 -m ShortModuleName
  

  Các đối số thử lại có thể khác với các đối số có sẵn trong lệnh ban đầu, vì vậy hãy kiểm tra các tham số được hỗ trợ trên trang web chính thức để biết bộ thử nghiệm đã chọn.

• Lần chạy thử trước đó - Nếu bạn muốn chạy lại lần chạy thử trước đó:

  • Cục bộ - Nếu quá trình chạy đã được bắt đầu trên máy chủ hiện tại, hãy nhập ID lần chạy thử nghiệm được thấy khi xem chi tiết về lần chạy thử nghiệm.

    

    Hình 9. Lần chạy thử cục bộ trước đó.

  • Từ xa - Nếu quá trình chạy được bắt đầu trên một máy chủ khác, hãy tải tệp kết quả kiểm tra lên bằng cách chọn Từ xa , nhấp vào Tải lên tệp kết quả kiểm tra và chọn tệp từ bộ nhớ cục bộ của bạn.

    

    Hình 10. Lần chạy thử trước đó từ xa.

Chọn thiết bị

Nhấp vào các hộp kiểm để chọn thiết bị cần phân bổ để chạy bộ thử nghiệm. Số lượng phân đoạn sẽ tự động thay đổi để phù hợp với số lượng thiết bị đã chọn.

Hình 11. Lựa chọn thiết bị.

Để chọn thiết bị theo thuộc tính không phải theo sê-ri thiết bị, bạn có thể nhập thủ công "Thông số thiết bị". Ví dụ: để chọn 3 thiết bị có tên sản phẩm là "bramble", hãy nhập thông tin sau:

product:bramble;product:bramble;product:bramble

Các thuộc tính được hỗ trợ là:

• build_id
• thiết bị_serial
• loại thiết bị
• tên máy chủ
• sản phẩm
• sản phẩm_biến thể
• sim_state

Tất cả các thiết bị được chọn phải ở trạng thái Khả dụng để thực hiện quá trình chạy thử và tất cả chúng đều chuyển sang trạng thái Đã phân bổ khi quá trình chạy thử nghiệm được thực thi. Quá trình chạy thử ở trạng thái Đã xếp hàng trong khi chờ thiết bị khả dụng.

Thêm hành động của thiết bị

Hành động của thiết bị là các tập lệnh có thể được thực thi trước mỗi lần chạy thử. Một số hành động của thiết bị đã được định cấu hình sẵn, chẳng hạn như nhấp nháy và khởi động lại. Để tạo hành động mới cho thiết bị, hãy xem Tạo hành động mới cho thiết bị .

Hình 12. Hành động của thiết bị.

Để thêm một hành động của thiết bị vào lần chạy thử, hãy nhấp vào Thêm hành động mới , chọn hộp kiểm cho các hành động cần thêm và nhấp vào Thêm (các) hành động . Hành động của thiết bị được thực hiện tuần tự. Bạn có thể sắp xếp lại các hành động bằng cách kéo chúng.

Hình 13. Sắp xếp lại các hành động.

Đặt tài nguyên kiểm tra

Tài nguyên kiểm tra là các tệp cần thiết để thực hiện chạy thử. Ví dụ: chạy CTS yêu cầu tệp android-cts*.zip và việc flash thiết bị yêu cầu bạn cung cấp hình ảnh bản dựng.

URL tải xuống cho tệp zip bộ thử nghiệm phải mặc định là các liên kết Google Drive được cung cấp cho đối tác. Bạn có thể chọn một tập tin khác bằng cách nhấp vào duyệt . Trong cửa sổ bật lên, bạn có thể nhập liên kết tải xuống tệp, sử dụng tệp từ kênh xây dựng đã được xác thực hoặc tải tệp lên để sử dụng từ bộ nhớ cục bộ.

Hình 14. Tài nguyên kiểm tra.

Dưới đây là cửa sổ bật lên để chọn tài nguyên kiểm tra bằng URL web. Bạn chỉ cần nhập liên kết url tải xuống và nhấp vào nút Chọn để xác nhận lựa chọn.

Hình 15. Bộ chọn tài nguyên kiểm tra - URL web.

Nếu bạn đã tải tài nguyên lên Google Grive, Google Cloud Storage (GCS) hoặc các kênh khác, bạn cũng có thể điều hướng đến tab của kênh cụ thể và chọn tài nguyên ở đó. Đây là một ví dụ để chọn tài nguyên từ google drive.

Hình 16. Bộ chọn tài nguyên kiểm tra - Google Drive.

Ngoài việc chỉ chọn tệp, ký tự đại diện cũng được hỗ trợ trong trường Tên tệp . Các tài liệu có thể được tìm thấy ở đây .

Hình 17. Bộ chọn tài nguyên kiểm tra - Hỗ trợ mẫu ký tự đại diện.

Bạn cũng có thể chọn tệp từ bộ lưu trữ tệp cục bộ của Trạm kiểm tra Android. Bạn có thể tải tệp lên bộ lưu trữ này hoặc sử dụng trực tiếp các tệp và thư mục cục bộ .

Hình 18. Bộ chọn tài nguyên kiểm tra - Lưu trữ tệp cục bộ.

Thêm cấu hình chạy lại

Bạn có thể lên lịch cho các lần chạy lại bắt đầu sau khi lần chạy chính hoàn tất và tải kết quả của nó, nhưng có thể sử dụng thiết bị, hành động hoặc tài nguyên khác.

Hình 19. Thêm cấu hình chạy lại.

Bắt đầu chạy thử

Sau khi nhập các thông tin cần thiết cho quá trình chạy thử, nhấn Start Test Run . Nếu tất cả thông tin đều hợp lệ thì quá trình chạy thử sẽ bắt đầu và bạn được chuyển hướng đến một trang để xem thông tin chi tiết và tiến trình của quá trình chạy thử.

Hình 20. Bắt đầu chạy thử.

Tạo một kế hoạch thử nghiệm

Kế hoạch kiểm tra được sử dụng để tạo ra các lần chạy thử nghiệm theo lịch trình định kỳ. Ví dụ: chạy CTS 9.0 hàng ngày vào lúc 5 giờ chiều. Để tạo kế hoạch kiểm tra mới, hãy nhấp vào Tạo kế hoạch kiểm tra mới .

Hình 21. Tạo kế hoạch kiểm tra.

Cấu hình kế hoạch kiểm tra

Nhập tên của kế hoạch kiểm tra và bất kỳ nhãn nào bạn muốn thêm. Sau đó chọn lịch để sử dụng.

• Thủ công - Kế hoạch kiểm tra chỉ tạo các lần chạy thử nghiệm khi người dùng nhấp vào Chạy kế hoạch kiểm tra trong trang danh sách kế hoạch kiểm tra.
• Định kỳ - Kế hoạch kiểm thử tự động lên lịch chạy thử theo lịch định kỳ đã chọn. Ví dụ: lên lịch chạy thử hàng ngày vào lúc 5 giờ chiều.
• Tùy chỉnh - Kế hoạch kiểm tra tự động lên lịch chạy kiểm tra dựa trên biểu thức cron đã nhập. Ví dụ: để lên lịch chạy thử hàng ngày vào lúc 5 giờ chiều, biểu thức cron là 0 17 * * * .

Hình 22. Cấu hình kế hoạch kiểm tra.

Thêm bộ thử nghiệm

Thêm bộ kiểm thử mà bạn muốn lên lịch theo kế hoạch kiểm thử bằng cách nhấp vào + Thêm cấu hình chạy thử . Chọn một bộ thử nghiệm từ danh sách thả xuống Tên và nhấp vào Bước tiếp theo . Sau đó, chọn thiết bị bạn muốn chạy thử nghiệm và nhấp vào Thêm cấu hình . Bạn có thể thêm nhiều cấu hình cho mỗi kế hoạch kiểm tra.

Hình 23. Cấu hình chạy thử.

Thêm hành động của thiết bị

Thêm các hành động thiết bị mà bạn muốn thực hiện trước mỗi lần chạy thử. Xem Thêm hành động của thiết bị để biết thêm chi tiết.

Hình 24. Thêm hành động của thiết bị.

Đặt tài nguyên kiểm tra

Việc thêm tài nguyên kiểm tra vào kế hoạch kiểm tra cũng giống như thêm chúng vào các lần chạy thử nghiệm riêng lẻ. Xem Đặt tài nguyên kiểm tra để biết thêm chi tiết.

Hình 25. Thiết lập tài nguyên kiểm tra.

Xem các lần chạy thử

Danh sách chạy thử

Xem danh sách các lần chạy thử nghiệm đã lên lịch trên trang Chạy thử nghiệm. Nhấp vào Xem để biết thêm chi tiết về quá trình chạy thử.

Bạn cũng có thể lọc danh sách bằng cách nhập một chuỗi vào thanh bộ lọc và nhấn phím Enter . Bạn có thể sử dụng nhiều bộ lọc bằng cách phân tách chúng bằng dấu phẩy. Bộ lọc trả về tất cả các hàng chứa văn bản chính xác (không khớp chuỗi con) trong bất kỳ cột nào, ngoại trừ Trạng thái và Đã tạo .

Bộ lọc trống trả về tất cả các hàng. Hiện tại không có cách nào để lọc các hàng có giá trị trống.

Hình 26. Danh sách chạy thử.

Chi tiết chạy thử

Bạn có thể xem chi tiết về lần chạy thử tại đây, chẳng hạn như trạng thái, nhật ký và kết quả.

Hình 27. Chi tiết chạy thử.

Trạng thái chạy thử

Tiến trình chạy thử được hiển thị trong phần Trạng thái. Nếu có thông báo liên quan, chẳng hạn như tiến trình tải xuống, lý do hủy hoặc thông báo lỗi, thì thông báo đó cũng được hiển thị ở đây.

Hình 28. Trạng thái chạy thử.

Các trạng thái chạy thử là:

• Đang chờ xử lý - Các tài nguyên cần thiết đang được tải xuống.
• Đã xếp hàng - Bài kiểm tra đã sẵn sàng để chạy khi có thiết bị.
• Đang chạy - Bài kiểm tra đang chạy trên thiết bị được phân bổ.
• Đã hoàn thành - Bài kiểm tra đã hoàn thành và báo cáo kết quả.
• Đã hủy - Bài kiểm tra đã bị người dùng hủy hoặc hết thời gian chờ trong khi cố gắng tìm các thiết bị có sẵn.
• Lỗi - Đã xảy ra lỗi khiến bài kiểm tra không thể chạy được.

Hủy chạy thử

Nếu quá trình chạy thử chưa hoàn tất, bạn có thể hủy nó bằng cách nhấp vào Hủy rồi nhấp vào Có trong hộp thoại xác nhận. Các lần chạy thử nghiệm cũng tự động bị hủy nếu chúng vẫn ở trạng thái Hàng đợi lâu hơn trường queue_timeout_seconds . Việc hủy quá trình chạy thử khi ở trạng thái Đang chạy có thể mất vài phút mới có hiệu lực.

Hình 29. Hủy chạy thử.

Kết quả chạy thử

Sau khi chạy thử xong, kết quả sẽ được thu thập và hiển thị. Bạn có thể xem thêm chi tiết bằng cách nhấp vào mũi tên cho mỗi lần chạy. Nhấp vào Xem tệp đầu ra để xem các tạo phẩm thử nghiệm được thu thập, chẳng hạn như test_result.xml và test_result_failures.html .

Hình 30. Kết quả chạy thử.

Bạn có thể xem nhật ký máy chủ trực tiếp và nhật ký Tradefed trong tab Nhật ký.

Hình 31. Tab nhật ký.

Kết quả cho từng mô-đun riêng lẻ nằm trên tab Kết quả kiểm tra.

Hình 32. Tab Kết quả Kiểm tra.

Bạn có thể tải xuống các tệp được sử dụng làm tài nguyên kiểm tra bằng cách nhấp vào Mở trong tab Tài nguyên kiểm tra.

Hình 33. Tab Tài nguyên kiểm tra.

Để xem chi tiết về quá trình chạy thử, chẳng hạn như create_time , hãy chuyển đến tab Cấu hình.

Hình 34. Tab cấu hình.

Các tính năng tiên tiến

Quản lý tập tin cấu hình

Trạm thử nghiệm Android sử dụng các tệp cấu hình được viết bằng YAML để tải các tùy chọn được xác định trước như thử nghiệm, xây dựng kênh và hành động của thiết bị. Tệp cấu hình ví dụ cho một số tùy chọn được hiển thị bên dưới.

// example_file.yaml
tests:
- id : android.cts.9_0.arm
  name: CTS 9.0 (ARM)
  test_resource_defs:
  - name: android-cts.zip
    default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
    test_resource_type: TEST_PACKAGE
  command: cts
  env_vars:
  - name: TF_PATH
    value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
  - name: LD_LIBRARY_PATH
    value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
  setup_scripts:
  output_file_patterns:
  - android-cts/logs/latest/.*
  - android-cts/results/latest/.*\.html
  - android-cts/results/latest/compatibility_result\..*
  - android-cts/results/latest/logo.png
  - android-cts/results/latest/test_result.xml
  result_file: test_result.xml
  java_properties:
  - name: CTS_ROOT
    value: ${TF_WORK_DIR}
  context_file_dir: android-cts/results/
  context_file_pattern: '[\d_\.]+\.zip'
  retry_command_line: retry --retry 0
  runner_sharding_args: --shard-count ${TF_SHARD_COUNT}

build_channels:
- id: google_drive
  name: Google Drive
  provider_name: Google Drive

device_actions:
- id: flash
  name: Flash
  test_resource_defs:
  - name: bootloader.img
    test_resource_type: DEVICE_IMAGE
  - name: radio.img
    test_resource_type: DEVICE_IMAGE
  - name: img.zip
    test_resource_type: DEVICE_IMAGE
  tradefed_target_preparers:
  - class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
    option_values:
    - name: work-dir
      values:
      - ${TF_WORK_DIR}
    - name: host-setup-command
      values:
      - adb -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL flash bootloader bootloader.img
      - fastboot -s $SERIAL flash radio radio.img
      - fastboot -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL -w update img.zip
      - adb -s $SERIAL wait-for-device
    - name: host-cmd-timeout
      values:
      - 10m

Khi thiết lập phiên bản Trạm kiểm tra Android, bạn có thể chia sẻ cấu hình của mình với những người dùng khác bằng cách xuất cấu hình đó dưới dạng tệp. Để thực hiện việc này, hãy truy cập trang Cài đặt và nhấp vào Xuất ở trên cùng bên phải.

Hình 35. Quản lý file cấu hình.

Sau khi tải xuống tệp cấu hình của bạn, hãy chia sẻ tệp với những người dùng khác. Họ có thể thêm tệp cấu hình vào phiên bản Trạm thử nghiệm Android của mình bằng cách nhấp vào Nhập và chọn tệp cấu hình.

Tạo một hành động thiết bị mới

Hành động của thiết bị được sử dụng để tự động hóa quá trình thiết lập thiết bị. Hành động là các tập lệnh được thực thi trên mỗi thiết bị mà thử nghiệm đang chạy trước mỗi lần chạy thử nghiệm, bao gồm cả trước khi thử lại. Để xem danh sách các tác vụ có sẵn của thiết bị, hãy đi tới trang Cài đặt và nhấp vào tab Hành động của thiết bị. Một số hành động của thiết bị đã được định cấu hình sẵn, chẳng hạn như khởi động lại và nhấp nháy.

Hình 36. Tab Hành động của thiết bị.

Thêm một hành động mới trên thiết bị

1. Nhấp vào Hành động của thiết bị mới .

   

   Hình 37. Nút tác vụ của thiết bị mới.

2. Nhập tên và mô tả.

   

   Hình 38. Tên hành động của thiết bị.

3. Nhấp vào Thêm Trình chuẩn bị mục tiêu .

4. Nhập tên đầy đủ của lớp Người chuẩn bị mục tiêu của Liên đoàn thương mại , ví dụ: com.android.tradefed.targetprep.RunHostCommandTargetPreparer .

   

   Hình 39. Thêm trình chuẩn bị mục tiêu.

   Bạn có thể tìm thấy danh sách các trình chuẩn bị mục tiêu có sẵn trong tài liệu tham khảo com.android.tradefed.targetprep .

   

   Hình 40. Danh sách Người chuẩn bị mục tiêu.

5. Thêm bất kỳ tùy chọn nào để sử dụng với trình chuẩn bị mục tiêu. Để xem các tùy chọn có sẵn, hãy kiểm tra targetprep để biết mã nguồn cho từng trình chuẩn bị mục tiêu trong AOSP:

   

   Hình 41. Ví dụ về tùy chọn hành động.

6. Để thêm tùy chọn, hãy nhấp vào Thêm tùy chọn chuẩn bị mục tiêu và nhập các giá trị được yêu cầu.

   

   Hình 42. Ví dụ lệnh hành động.

7. Xác định các tài nguyên kiểm tra cần thiết để thực hiện hành động của thiết bị, ví dụ: xây dựng hình ảnh để nhấp nháy. Để thêm định nghĩa tài nguyên, hãy nhấp vào Thêm tài nguyên kiểm tra và điền vào các trường bắt buộc. Nếu bạn biết tệp của mình nằm ở đâu, bạn có thể cung cấp URL tải xuống mặc định bằng cách nhấp vào duyệt . Nếu người chuẩn bị mục tiêu chấp nhận thư mục làm tài nguyên kiểm tra, hãy chọn Giải nén . Sau đó chỉ định thư mục Đích tương đối trong thư mục làm việc tạm thời và Tên Tệp sẽ được giải nén. Nếu không có tên tệp nào được cung cấp, tất cả các tệp sẽ được giải nén khỏi tài nguyên kiểm tra.

   

   Hình 43. Tài nguyên kiểm tra hành động.

8. Nhấp vào Cập nhật .

   

   Hình 44. Hành động lưu thay đổi.

Quản lý bài kiểm tra

Chỉnh sửa bài kiểm tra

Để chỉnh sửa bài kiểm tra đã lưu, hãy truy cập trang Kiểm tra và nhấp vào Chỉnh sửa trên hàng bài kiểm tra bạn muốn sửa đổi. Sau khi thay đổi cấu hình kiểm tra nhấn Update .

Hình 45. Chỉnh sửa bài kiểm tra.

Thêm một bài kiểm tra mới

Để thêm bài kiểm tra mới, hãy truy cập trang Kiểm tra và nhấp vào Tạo bài kiểm tra mới . Nhập thông tin thích hợp và nhấp vào Tạo .

Hình 46. Tạo một bài kiểm tra.

Hình 47. Sao chép bài kiểm tra.

Xuất cấu hình máy chủ

Sau khi định cấu hình máy chủ, bạn có thể xuất cấu hình của máy chủ đó sang một tệp. Bạn có thể tải tệp này lên các máy chủ khác để sao chép cấu hình đã lưu.

Để xuất cấu hình của máy chủ, hãy đi tới trang Cài đặt và nhấp vào Xuất ở góc trên cùng bên phải.

Hình 48. Xuất cấu hình máy chủ.

Để nhập tệp cấu hình máy chủ, hãy truy cập trang Cài đặt và nhấp vào Nhập ở góc trên cùng bên phải.

Hình 49. Nhập cấu hình máy chủ.

Sử dụng các tập tin và thư mục cục bộ

Bắt đầu từ phiên bản R11, các tệp trong thư mục $HOME/.ats_storage có thể tự động truy cập được trong Trạm kiểm tra Android. Sao chép hoặc di chuyển tệp vào thư mục đó, sau đó bạn có thể chọn tệp đó từ tab Tệp cục bộ khi lên lịch chạy thử.

cp /path/to/file $HOME/.ats_storage

Hình 50. Chọn một tệp từ thư mục $HOME/.ats_storage .

Bạn có thể gắn các thư mục bổ sung vào kho lưu trữ tệp cục bộ bằng cờ --mount_local_path .

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

Hình 51. Các thư mục bổ sung được gắn vào kho lưu trữ tệp cục bộ.

Bật chế độ nhiều máy chủ

Với chế độ Nhiều máy chủ, người dùng có thể sử dụng một máy chủ điều khiển ATS duy nhất để quản lý các thiết bị và kiểm tra trên nhiều máy chủ nhân viên ATS.

Hình 52. Kiến trúc chế độ nhiều máy chủ.

1. Để khởi động bộ điều khiển ATS, sử dụng lệnh sau:

   mtt start --operation_mode=ON_PREMISE
   

2. Kiểm tra bộ điều khiển có thể truy cập được tại http://${CONTROLLER_HOSTNAME}:8000 .

3. Để bắt đầu công nhân, sử dụng lệnh sau:

   mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
   

Nếu mạng của bạn không cho phép các máy chủ liên lạc với nhau, bạn cần làm theo các hướng dẫn thiết lập nâng cao hơn bên dưới trên nhân viên ATS.

1. Kết nối hai máy chủ bằng đường hầm SSH. Chọn cổng cho cổng máy chủ chính và máy chủ tệp, ví dụ: 9000 và 9006.

   ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
   

2. Cấu hình và khởi động ATS.

   DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
   socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
   socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
   mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                   --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                   --operation_mode=ON_PREMISE
   

Trình dọn dẹp tập tin

Trình dọn dẹp tệp là một công việc định kỳ chạy hàng giờ để dọn dẹp các tệp dựa trên cấu hình do người dùng xác định. ATS có hai cấu hình mặc định để lưu trữ kết quả chạy thử và xóa các tệp tạm thời. Hướng dẫn này giải thích cách tùy chỉnh các chính sách và cấu hình để quản lý tệp của bạn một cách hiệu quả.

Chính sách

Chính sách xác định thao tác sẽ được thực hiện trên tệp hoặc thư mục và tiêu chí để chọn mục tiêu. Các hoạt động có sẵn được hiển thị trong bảng:

Tiêu chí dựa trên thuộc tính tệp và thông tin hệ thống. Các tiêu chí có sẵn được thể hiện trong bảng:

Hình 53. Thêm chính sách dọn dẹp tệp mới.

Cấu hình

Một cấu hình kết hợp một hoặc nhiều chính sách với các thư mục cụ thể. Các tệp và thư mục trong các thư mục được chỉ định sẽ được xử lý dựa trên các chính sách đã xác định. Các chính sách được áp dụng theo thứ tự chúng xuất hiện trong config.

Tất cả các thư mục đích phải được đặt trong thư mục /data . Nếu cấu hình của bạn chỉ định thư mục đích là logs thì nó được hiểu là /data/logs .

Hình 54. Chỉnh sửa cấu hình trình dọn dẹp tệp.

Cài lại

Nhấp vào Đặt lại cài đặt sẽ hoàn nguyên cấu hình trình dọn dẹp tệp về trạng thái mặc định. Hành động này sẽ xóa TẤT CẢ các mục tùy chỉnh.

Hình 55. Đặt lại cài đặt dọn dẹp tập tin.

Ủng hộ

Báo cáo lỗi

Đóng góp của bạn cho Trạm thử nghiệm Android giúp cải thiện sự phát triển của công cụ và chúng tôi muốn có ý kiến ​​đóng góp của bạn! Xem ghi chú phát hành ATS để biết chi tiết về bản phát hành mới nhất. Để báo cáo lỗi hoặc đưa ra đề xuất, vui lòng gửi báo cáo lỗi . Đối tác nên báo cáo lỗi hoặc đề xuất thông qua các kênh đối tác của họ.