Thiết lập Eclipse

Làm theo các bước sau để thiết lập Tradefed bằng Eclipse.

Tạo một không gian làm việc riêng để phát triển Trade Federation, không sử dụng lại một không gian làm việc đã được sử dụng để phát triển thiết bị Android.

Nếu cần, bạn có thể tải Eclipse IDE dành cho nhà phát triển Java xuống từ: eclipse.org/downloads

Tạo dự án

  1. Chạy make một lần từ dòng lệnh. Thao tác này sẽ tạo các thư viện bên ngoài mà các dự án bên dưới phụ thuộc vào.
  2. Đặt biến đường dẫn lớp TRADEFED_ROOT trong Window > Preferences > Java > Build Path> Classpath Variables và trỏ biến đó đến thư mục gốc của nguồn tradefed
  3. Đặt biến đường dẫn TRADEFED_ROOT trong Window > Preferences > General > Workspace > Linked Resources và trỏ biến đó đến gốc nguồn được trao đổi

  4. Sử dụng trình hướng dẫn File > Import...-> General > Existing Projects into workspace" để đưa các dự án Java nguồn mở này vào theo các đường dẫn sau:

    prebuilts/misc/common/ddmlib\*
tools/loganalysis
tools/loganalysis/tests
tools/tradefederation/core
tools/tradefederation/core/tests
tools/tradefederation/contrib
tools/tradefederation/core/remote
platform_testing/libraries/health/runners/longevity/host
platform_testing/libraries/annotations
platform_testing/libraries/health/composers/host

  5. Nếu bạn muốn xem mã nguồn ddmlib, hãy đính kèm mã nguồn qua một nhánh công cụ chưa được gói, chẳng hạn như /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java.

  6. Nếu bạn cũng muốn tải các dự án harness CTS, hãy nhập:

    test/suite_harness/common/util
test/suite_harness/common/host-side/util
test/suite_harness/common/host-side/tradefed

Tự động định dạng

LƯU Ý: Các tệp cần thiết nằm trong development/ide/eclipse ở cây nguồn toàn bộ nền tảng. Vì vậy, bạn cần kiểm tra một nhánh nền tảng như main để lấy các tệp này: /development/main/ide/eclipse/

Sử dụng các tệp lựa chọn ưu tiên trong Eclipse để tự động đặt trình định dạng theo hướng dẫn quy tắc của Android. Cách thực hiện việc này trong Studio:

  1. Chuyển đến Window > Preferences > Java > Code Style (Cửa sổ > Lựa chọn ưu tiên > Java > Kiểu mã).
  2. Trong phần Formatter (Trình định dạng), hãy nhập tệp android-formatting.xml.
  3. Trong phần Organization > Imports (Sắp xếp > Nhập), hãy nhập tệp android.importorder.

Xoá khoảng trắng ở cuối

Cách buộc Eclipse xoá tất cả khoảng trắng ở cuối:

  1. Chuyển đến Window (Cửa sổ) > Preferences (Lựa chọn ưu tiên) -> Java -> Editor (Trình chỉnh sửa) -> Save Actions (Lưu thao tác).
  2. Sau đó, Thao tác bổ sung -> Định cấu hình -> Mã > Thẻ Sắp xếp -> Trình định dạng.
  3. Chọn Xoá khoảng trắng theo sau.
  4. Nhấp vào Áp dụng và đóng.

Kiểm tra kiểu mã

Khi bạn gửi danh sách thay đổi, một trình bổ trợ tự động tải lên trước sẽ chạy để kiểm tra định dạng mã: google-java-format

Điều này giúp định dạng mã theo tiêu chuẩn chung.

Gỡ lỗi Eclipse

Nếu muốn chạy mã TF thông qua một trình gỡ lỗi trong Eclipse, trước tiên, bạn nên tạo một bài kiểm thử đơn vị cho mã liên quan vì đây sẽ là cách đơn giản và nhanh nhất để thực hiện chức năng.

Để gỡ lỗi kiểm thử đơn vị TF, bạn chỉ cần nhấp chuột phải vào kiểm thử đó rồi chọn Debug As > JUnit test (Gỡ lỗi dưới dạng > kiểm thử JUnit).

Để gỡ lỗi kiểm thử chức năng TF, hãy làm theo hướng dẫn trong phần trước để chạy kiểm thử chức năng, nhưng sử dụng trình đơn Run > Debug configurations (Chạy > Cấu hình gỡ lỗi).

Để gỡ lỗi chính chương trình TF, khi chạy bất kỳ cấu hình nào, hãy làm theo hướng dẫn trong phần trước để chạy kiểm thử chức năng, nhưng cung cấp đối số dòng lệnh cho cấu hình bạn muốn chạy trong bước 4. Vì vậy, để gỡ lỗi cấu hình "Instrument", hãy chuyển đến trình đơn Run > Debug configuration (Chạy > Cấu hình gỡ lỗi) rồi đặt thẻ Arguments (Đối số) trong cấu hình gỡ lỗi của Eclipse thành -- package <package to run> instrument.

Gỡ lỗi từ xa bằng Eclipse

Hãy làm theo các bước sau để gỡ lỗi từ xa một phiên được hoán đổi bắt đầu từ dòng lệnh tradefed.sh:

  1. Bắt đầu tradefed.sh bằng cờ gỡ lỗi: TF_DEBUG=1 tradefed.sh
  2. Chờ cho đến khi bạn thấy lời nhắc này từ JVM: Listening for transport dt_socket at address: 10088 Điều này có nghĩa là JVM đang chờ trình gỡ lỗi đính kèm tại cổng 10088.
  3. Gắn bằng tính năng gỡ lỗi từ xa của Eclipse từ trình đơn chính: Chọn Run > Debug Configurations... (Chạy > Cấu hình gỡ lỗi…).
  4. Trong hộp thoại bật lên, chọn Remote Java Application (Ứng dụng Java từ xa) trên trình đơn bên trái.
  5. Nhấp vào biểu tượng Cấu hình khởi chạy mới trên thanh thao tác.
  6. Đặt tên cho cấu hình theo ý bạn rồi chọn tradefederation làm dự án.
  7. Điền địa chỉ đã cung cấp trước đó cho cổng.
  8. Chuyển sang thẻ Source (Nguồn) rồi thêm các dự án tradefederation và google-tradefed vào Source Lookup Path (Đường dẫn tra cứu nguồn).
  9. Nhấp vào Gỡ lỗi để bắt đầu phiên gỡ lỗi.

Trình gỡ lỗi đính kèm vào quy trình JVM đang nghe, và thiết bị đầu cuối chạy tradefed.sh sẽ hiện lời nhắc tf>.

Để thực hiện từng bước trong mã ở chế độ gỡ lỗi, hãy đặt điểm ngắt trong Eclipse và gọi lệnh Tradefed (tức là run <test>) trong thiết bị đầu cuối. Để gỡ lỗi mọi thứ trong quá trình khởi động TF, bạn có thể đặt điểm ngắt trước, sau đó đính kèm trình gỡ lỗi Eclipse.

MẸO: Để sử dụng một cổng thay thế, hãy thêm TF_DEBUG_PORT=nnn vào lệnh ở bước 1 ở trên. Bạn thậm chí có thể sử dụng tính năng này trong môi trường phát hành chính thức nếu gặp phải các lỗi treo bí ẩn cần điều tra: thay đổi suspend=y thành suspend=n trong tradefed.sh và bắt đầu bằng cờ gỡ lỗi. JVM sẽ không chờ trình gỡ lỗi đính kèm, nhưng bạn có thể làm như vậy bất cứ lúc nào miễn là quy trình vẫn đang chạy.

Gỡ lỗi từ xa bằng JDB

Để sử dụng Trình gỡ lỗi Java JDB, hãy làm theo các bước tương tự như đối với Eclipse:

  1. Khởi động tradefed.sh bằng cờ gỡ lỗi: TF_DEBUG=1 tradefed.sh
  2. Chờ cho đến khi bạn nhìn thấy lời nhắc của máy ảo JVM: Listening for transport dt_socket at address: 10088.

  3. Kết nối jdb. Ví dụ: từ croot chạy:

    jdb -attach 10088 \
    -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src

  4. Hãy chờ kết nối và gỡ lỗi! Chạy man jdb để được trợ giúp thêm.

Kiểm tra mức độ sử dụng mã

  1. Cài đặt trình bổ trợ Eclemma.
  2. Chuyển đến Help > Install New Software (Trợ giúp > Cài đặt phần mềm mới) rồi trỏ trình hướng dẫn đến: http://update.eclemma.org/
  3. Sau khi cài đặt, hãy chọn tuỳ chọn kiểm thử Coverage As > JUnit (Mức độ sử dụng dưới dạng > JUnit) để chạy một quy trình kiểm thử mức độ sử dụng mã.