Thiết lập Eclipse

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

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

Nếu cần, bạn có thể tải IDE Eclipse 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 phụ thuộc vào các dự án dưới đây.
  2. Đặt biến đường dẫn lớp TRADEFED_ROOT trong Window > Preferences > Java > Build Path> Classpath Variables và trỏ biến đó đến gốc nguồn được trao đổi của bạn
  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 File > Import...-> General > Existing Projects into workspace"trình hướng dẫn để đưa các dự án Java nguồn mở này vào trong 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 (không bắt buộc) 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 khai thác CTS (không bắt buộc), hãy nhập:

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

Định dạng tự động

LƯU Ý: Các tệp cần thiết nằm trong development/ide/eclipse ở chế độ toàn bộ nền tảng cây nguồn. Vì vậy, bạn sẽ cần khám phá một nhánh nền tảng, chẳng hạn như main để tải các tệp này: /development/main/ide/eclipse/

Sử dụng các tệp tuỳ chọn trong Eclipse để tự động đặt trình định dạng thành Hướng dẫn quy tắc lập trình Android. Cách thực hiện việc này trong Studio:

  1. Chuyển đến Window > Lựa chọn ưu tiên > Java > Kiểu mã.
  2. Trong Formatter, hãy nhập tệp android-formatting.xml.
  3. Trong phần Sắp xếp > Nhập, nhập tệp android.importorder.

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

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

  1. Chuyển đến Window > Tuỳ chọn -> Java -> Trình chỉnh sửa -> Lưu hành động.
  2. Sau đó là Thao tác bổ sung -> Định cấu hình -> Mã > Sắp xếp thẻ -> 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 gửi danh sách thay đổi, một hook tải lên trước tự động sẽ chạy để kiểm tra định dạng mã: google-java-format

Điều này giúp định dạng mã của bạn 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, bạn nên trước tiên, hãy tạo một kiểm thử đơn vị cho mã liên quan vì đây sẽ là cách đơn giản nhất và cách nhanh nhất để thực thi chức năng.

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

Để 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 lệnh Run > (Chạy >) Trình đơn gỡ lỗi cấu hình.

Để 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 các hướng dẫn trong phần trước về cách chạy kiểm thử chức năng nhưng cung cấp các đối số dòng lệnh cho cấu hình bạn muốn chạy ở bước 4. Loại đối thủ sau lượt đánh bóng để gỡ lỗi "Instrument" hãy chuyển đến phần Run > (Chạy >) Cấu hình gỡ lỗi và đặ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 đổi lấy dữ liệu bắt đầu từ Dòng lệnh tradefed.sh:

  1. Bắt đầu Tradefeed.sh với 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. Đính kèm với tính năng gỡ lỗi từ xa của Eclipse từ trình đơn chính: Chọn Run > (Chạy >) Gỡ lỗi Cấu hình....
  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 chạy mới trên thanh thao tác.
  6. Đặt tên cho cấu hình theo ý muốn và chọn tradefederation (Liên kết thương mại) 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 tradefederation (liên kết thương mại) dự án và google-tradefed vào Đường dẫn tìm kiếm 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 quá trình nghe JVM và cửa sổ dòng lệnh đang chạy tradefed.sh cho thấy lời nhắc của tf>.

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

MẸO: Để sử dụng 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 sản xuất nếu bạn treo lỗi để đ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 đợi trình gỡ lỗi đính kèm, nhưng bạn có thể làm bất cứ lúc nào miễn là quá trình vẫn đang chạy.

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

Để sử dụng JDB của Trình gỡ lỗi Java, hãy làm theo các bước tương tự như các bước cho 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ụ: trong lần chạy croot:

    jdb -attach 10088 \
        -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
    
  4. Chờ kết nối và gỡ lỗi! Hãy 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 Trợ giúp > Cài đặt Phần mềm mới và trỏ trình hướng dẫn đến: http://update.eclemma.org/
  3. Sau khi cài đặt, chọn Phạm vi bao phủ dưới dạng > Tuỳ chọn thử nghiệm JUnit để tiến hành một chạy mức độ sử dụng mã.