Chạy Winscope

Tính năng theo dõi Winscope là một phần của khung Android. Trang này trình bày các bước cần thiết để tải xuống, tạo và chạy trình xem dấu vết Winscope cục bộ.

Tạo Winscope cục bộ

Làm theo các bước sau để thiết lập máy tính chạy Winscope tracer:

1. Tải nguồn Android xuống.

2. Chuyển đến thư mục Winscope:

   cd development/tools/winscope
   

3. Cài đặt các phần phụ thuộc bằng cách sử dụng:

   npm install
   

   Để xem danh sách các lệnh hiện có, hãy chạy: npm run

4. Tạo tất cả các mục tiêu kiểm thử và mục tiêu phát hành công khai bằng cách sử dụng:

   npm run build:prod
   

5. Chạy Winscope bằng cách:

   npm run start
   

Xây dựng các phần riêng biệt

Bạn có thể tạo riêng từng phần của Winscope bằng các lệnh sau:

Chạy chương trình kiểm thử

Winscope chứa các kiểm thử đơn vị và kiểm thử toàn diện. Để chạy các kiểm thử này, hãy sử dụng npm run <command>:

Kiểm thử toàn diện

Trước khi chạy các kiểm thử từ đầu đến cuối, bạn phải khởi động công cụ từ xa và cài đặt đúng phiên bản trình điều khiển Chrome. Trong đoạn mã sau, lệnh run test:e2e sẽ tự động cài đặt trình điều khiển Chrome.

$ npm run start
$ npm run start:remote_tool_mock
$ npm run test:e2e

Bảng sau đây liệt kê các lệnh cần thiết và nội dung mô tả của các lệnh đó. Để chạy các lệnh này, hãy sử dụng npm run command:

Cập nhật mối liên kết @IntDef

@IntDef là một chú giải được dùng trong Android để hạn chế các giá trị có thể có của một số nguyên. Winscope sử dụng một mối liên kết của các chú thích này để hiển thị tên của giá trị thay vì số nguyên.

Nếu các giá trị @IntDef mới được thêm vào khung Android nhưng không được cập nhật trong Winscope, thì các giá trị này sẽ xuất hiện dưới dạng giá trị số nguyên thô thay vì chuỗi mô tả. Để khắc phục vấn đề này, hãy cập nhật tệp ánh xạ IntDef (development/tools/winscope/src/common/intDefMapping.json).

Để tự động cập nhật mối liên kết @IntDef, hãy làm như sau:

1. Chạy tập lệnh update_intdef_mappings.sh trong thư mục development/tools/winscope/scripts/ trên cây Android cục bộ. Tập lệnh này kích hoạt quy trình chú thích để trích xuất các giá trị @IntDef mới nhất từ mã và cập nhật intDefMapping.json:

   cd development/tools/winscope
   ./scripts/update_intdef_mappings.sh
   

2. Xác nhận các thay đổi đối với src/common/intDefMapping.json bằng lệnh git commit và tải các thay đổi đó lên bằng lệnh repo upload.

Nếu không có tập lệnh, hãy làm theo các bước sau để cập nhật ánh xạ @IntDef theo cách thủ công từ thư mục gốc Android ($ANDROID_BUILD_TOP):

1. Tạo bản dựng framework-minus-apex-intdefs để bộ tiền xử lý chú giải chạy:

   m framework-minus-apex-intdefs
   

2. Sao chép tệp intDefMapping.json đã tạo vào kho lưu trữ được tạo sẵn:

   $ python3 -c 'import sys,json,collections; print(json.dumps(collections.OrderedDict(sorted(collections.ChainMap(*map(lambda x:json.load(open(x)), sys.argv[1:])).items())), indent=2))' $(find out/soong/.intermediates/frameworks/base -iname intDefMapping.json) > ./development/tools/winscope/src/common/intDefMapping.json
   

3. Tải các thay đổi lên Winscope bằng cách sử dụng repo upload.

Các lệnh khác

Ngoài các bản dựng và kiểm thử, tập lệnh Winscope còn có các chức năng khác, như minh hoạ trong bảng. Để chạy các kiểm thử này, hãy sử dụng npm run command:

Khắc phục sự cố

Hãy làm theo các mẹo sau để khắc phục sự cố:

• Lỗi ProtocolError: missing required '<FIELD>' hoặc TypeError: Cannot read property '<PROP>' of null

  • Điều này xảy ra khi tệp theo dõi được tạo bằng một định nghĩa proto mới, chứa các trường bắt buộc mới.

    1. Đảm bảo bạn đang mở dấu vết trên đúng phiên bản Winscope (master, S hoặc R).

    2. Nếu bạn tạo trường mới trên proto, hãy biên dịch lại các proto trong Winscope bằng cách sử dụng npm run build:protos.

• Một số phiên bản phần phụ thuộc đã cài đặt không chính xác (không tạo được bản dựng)

  • Huỷ bỏ các thay đổi đối với package.json và package-lock.json. Xoá node_modules. Chạy lại npm install.

• Tôi đã thêm một trường mới vào một trong các tệp proto. Làm cách nào để hiển thị thông tin này?

  • Winscope sử dụng các định nghĩa proto từ thời điểm được biên dịch, vì vậy, các trường mới sẽ không xuất hiện theo mặc định. Để hiện các trường mới, hãy tạo lại các proto bằng cách sử dụng npm run build:protos.