japi-tuân thủ-kiểm tra - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

japi-tuân thủ-kiểm tra - Kiểm tra khả năng tương thích ngược của API thư viện Java

MÔ TẢ

TÊN:
Trình kiểm tra tuân thủ Java API (trình kiểm tra tuân thủ Nhật Bản) Kiểm tra khả năng tương thích ngược
của một API thư viện Java

SỰ MIÊU TẢ:
Trình kiểm tra tuân thủ Java API (Java ACC) là một công cụ để kiểm tra ngược
khả năng tương thích nhị phân / nguồn của một API thư viện Java. Công cụ kiểm tra các lớp
khai báo các phiên bản cũ và mới và phân tích các thay đổi có thể phá vỡ
khả năng tương thích: các thành viên lớp bị loại bỏ, thêm các phương thức trừu tượng, v.v. Sự phá vỡ
khả năng tương thích nhị phân có thể dẫn đến sự cố hoặc hành vi không chính xác của
ứng dụng khách được tạo bằng phiên bản cũ của thư viện nếu chúng chạy với phiên bản mới. Vỡ
khả năng tương thích của nguồn có thể dẫn đến lỗi biên dịch lại với thư viện mới
phiên bản.

Java ACC dành cho các nhà phát triển thư viện và người bảo trì hệ điều hành, những người
quan tâm đến việc đảm bảo khả năng tương thích ngược (nghĩa là cho phép các máy khách cũ chạy hoặc
được biên dịch lại với một phiên bản thư viện mới).

Công cụ này là phần mềm miễn phí: bạn có thể phân phối lại nó và / hoặc sửa đổi nó trong
các điều khoản của GNU LGPL hoặc GNU GPL.

SỬ DỤNG:
japi-tuân thủ-kiểm tra [tùy chọn]

THÍ DỤ:
japi-tuân thủ-kiểm tra OLD.jar NEW.jar

OR

người kiểm tra tuân thủ Nhật Bản -lib TÊN -cũ CŨ.xml -Mới NEW.xml OLD.xml và NEW.xml là
Các bộ mô tả XML:



1.0





/ path1 / to / JAR (s) / / path2 / to / JAR (s) / ...



THÔNG TIN TÙY CHỌN:
-h| -giúp đỡ

In phần trợ giúp này.

-v| -mục tiêu

Thông tin phiên bản in.

-dumpversion

In phiên bản công cụ (1.4.3) và không làm bất cứ điều gì khác.

CÁC VẤN ĐỀ CHUNG TÙY CHỌN:
-l| -lib | -library TÊN

Tên thư viện (không có phiên bản).

-d1| -old | -o PATH

Bộ mô tả của phiên bản thư viện thứ nhất (cũ). Nó có thể là một trong những điều sau:

1. Java ARchive (* .jar) 2. XML-descriptor (tệp VERSION.xml):



1.0





/ path1 / to / JAR (s) / / path2 / to / JAR (s) /

...



...

3. Kết xuất API được tạo bởi -bãi rác tùy chọn 4. Thư mục với Java ARchives 5. Dấu phẩy
danh sách phân tách các ARchives Java 6. Danh sách các thư mục được phân tách bằng dấu phẩy với Java
kho lưu trữ

Nếu bạn đang sử dụng 1, 4-6 loại bộ mô tả thì bạn nên chỉ định số phiên bản
với -V1 và -V2 tùy chọn quá.

Nếu bạn đang sử dụng * .jar làm bộ mô tả thì công cụ sẽ cố gắng triển khai
phiên bản từ tệp MANIFEST.MF.

-d2| -new | -n PATH

Bộ mô tả của phiên bản thư viện thứ 2 (mới).

EXTRA TÙY CHỌN:
-khách hàng| -app PATH

Tùy chọn này cho phép chỉ định máy khách Java ARchive cần được kiểm tra
khả năng chuyển sang phiên bản thư viện mới.

-nhị phân

Chỉ hiển thị sự cố tương thích "Nhị phân". Tạo báo cáo cho
"bin_compat_report.html".

-Source

Chỉ hiển thị sự cố tương thích "Nguồn". Tạo báo cáo cho
"src_compat_report.html".

-V1| -version1 NUM

Chỉ định phiên bản API đầu tiên bên ngoài bộ mô tả. Tùy chọn này là cần thiết nếu bạn có
ưa thích một loại mô tả thay thế (xem -d1 Tùy chọn).

Trong trường hợp chung, bạn nên chỉ định nó trong bộ mô tả XML:



PHIÊN BẢN



-V2| -version2 NUM

Chỉ định phiên bản thư viện thứ 2 bên ngoài bộ mô tả.

-s| -strict

Coi tất cả các cảnh báo về khả năng tương thích của API là sự cố.

-giữ nội bộ

Đừng bỏ qua việc kiểm tra các gói sau:

* impl * * internal * * ví dụ * * com.oracle * * com.sun * * COM.rsa * * sun * * sunw *

-skip-nội bộ MẪU

Không kiểm tra các gói bên trong có khớp với mẫu không.

-bãi rác| -dump-api PATH

Kết xuất API thư viện sang tệp định dạng TXT được nén. Bạn có thể chuyển nó bất cứ nơi nào và vượt qua
thay vì bộ mô tả. Ngoài ra, nó có thể được sử dụng để gỡ lỗi công cụ. Tương thích
phiên bản kết xuất: 1.0 <= V <= 1.0

-lớp-danh sách PATH

Tùy chọn này cho phép chỉ định một tệp với danh sách các lớp cần được kiểm tra,
các lớp khác sẽ không được kiểm tra.

-chú thích-danh sách PATH

Chỉ định một tệp có danh sách các chú thích. Công cụ sẽ chỉ kiểm tra các lớp
được chú thích bởi các chú thích từ danh sách này. Các lớp khác sẽ không được kiểm tra.

-skip-không dùng nữa

Bỏ qua phân tích các phương thức và lớp không dùng nữa.

-bỏ qua các lớp học PATH

Tùy chọn này cho phép chỉ định một tệp có danh sách các lớp không nên
đã kiểm tra.

-skip-gói PATH

Tùy chọn này cho phép chỉ định một tệp với danh sách các gói không nên
đã kiểm tra.

-ngắn PATH

Tạo báo cáo ngắn mà không có phần 'Phương pháp được Thêm vào'.

-báo cáo-đường dẫn PATH

Đường dẫn đến báo cáo khả năng tương thích. Vỡ nợ:

compat_reports / LIB_NAME / V1_to_V2 / compat_report.html

-bin-báo cáo-đường dẫn PATH

Đường dẫn đến báo cáo khả năng tương thích "Nhị phân". Vỡ nợ:

compat_reports / LIB_NAME / V1_to_V2 / bin_compat_report.html

-src-báo cáo-đường dẫn PATH

Đường dẫn đến báo cáo khả năng tương thích "Nguồn". Vỡ nợ:

compat_reports / LIB_NAME / V1_to_V2 / src_compat_report.html

-nhanh chóng

Phân tích nhanh. Vô hiệu hóa:

- phân tích tên tham số phương thức - phân tích giá trị trường lớp - phân tích
sử dụng các phương thức trừu tượng được bổ sung - phân biệt các phương thức và lớp không dùng nữa

-loại

Cho phép sắp xếp dữ liệu trong kết xuất API.

-show-truy cập

Hiển thị mức độ truy cập của các phương pháp không công khai được liệt kê trong báo cáo.

-hide-mẫu

Ẩn thông số mẫu trong báo cáo.

-hide-gói

-tối thiểu

Không làm gì cả.

-show-pack

Hiển thị tên gói trong báo cáo.

-limit-bị ảnh hưởng LIMIT

Số lượng tối đa các phương pháp bị ảnh hưởng được liệt kê trong phần mô tả của phương pháp đã thay đổi
gõ vào báo cáo.

KHÁC TÙY CHỌN:
-kiểm tra

Chạy thử nghiệm nội bộ. Tạo hai phiên bản không tương thích của thư viện mẫu và chạy
công cụ để kiểm tra tính tương thích của chúng. Tùy chọn này cho phép kiểm tra xem công cụ
hoạt động chính xác trong môi trường hiện tại.

-gỡ lỗi

Chế độ kiểm lỗi. In thông tin gỡ lỗi trên màn hình. Lưu các giai đoạn phân tích trung gian
trong thư mục gỡ lỗi:

gỡ lỗi / LIB_NAME / VER /

Cũng xem xét sử dụng -bãi rác tùy chọn để gỡ lỗi công cụ.

-chức vụ TÊN

Thay đổi tên thư viện trong tiêu đề báo cáo thành NAME. Theo mặc định sẽ được hiển thị
tên được chỉ định bởi -l tùy chọn.

-jdk-đường dẫn PATH

Đường dẫn đến cây cài đặt JDK (ví dụ: / usr / lib / jvm / java-7-openjdk-amd64).

BÁO CÁO:
Báo cáo khả năng tương thích sẽ được tạo để:

compat_reports / LIB_NAME / V1_to_V2 / compat_report.html

EXIT MÃ:
0 - Tương thích. Công cụ đã chạy mà không có bất kỳ lỗi nào. khác XNUMX - Không tương thích hoặc
công cụ đã chạy với lỗi.

MORE THÔNG TIN:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

Sử dụng công cụ kiểm tra tuân thủ japi trực tuyến bằng các dịch vụ onworks.net