japi-compliance-checker - Online în cloud

PROGRAM:

NUME

japi-compliance-checker - Verificați compatibilitatea cu versiunea anterioară a unei biblioteci API Java

DESCRIERE

NUME:
Java API Compliance Checker (japi-compliance-checker) Verificați compatibilitatea cu versiunea anterioară
a unei biblioteci API Java

DESCRIERE:
Java API Compliance Checker (Java ACC) este un instrument pentru verificarea înapoi
compatibilitatea binar/sursă a unei biblioteci API Java. Instrumentul verifică clasele
declarații ale versiunilor vechi și noi și analizează modificările care se pot rupe
compatibilitate: membrii clasei eliminați, metode abstracte adăugate, etc. Ruperea
compatibilitatea binară poate duce la prăbușirea sau un comportament incorect al existentei
clienții construiti cu o versiune veche a unei biblioteci dacă rulează cu una nouă. Rupere
compatibilitatea sursei poate duce la erori de recompilare cu o nouă bibliotecă
versiune.

Java ACC este destinat dezvoltatorilor de biblioteci și întreținătorilor de sisteme de operare care
sunt interesați să asigure compatibilitatea anterioară (adică permiteți clienților vechi să ruleze sau
pentru a fi recompilat cu o nouă versiune a unei biblioteci).

Acest instrument este software gratuit: îl puteți redistribui și/sau modifica sub
termenii GNU LGPL sau GNU GPL.

UTILIZARE:
japi-compliance-checker [opțiuni]

EXEMPLU:
japi-compliance-checker OLD.jar NEW.jar

OR

japi-compliance-checker -lib NUME -vechi OLD.xml -nou NEW.xml OLD.xml și NEW.xml sunt
Descriptori XML:



1.0





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



INFORMAŢII OPȚIUNI:
-h|-ajutor

Imprimați acest ajutor.

-v|-versiunea

Informații despre versiunea tipărită.

-versiunea de gunoi

Imprimați versiunea instrumentului (1.4.3) și nu faceți nimic altceva.

GENERAL OPȚIUNI:
-l|-lib|-bibliotecă NUME

Numele bibliotecii (fără versiune).

-d1|-vechi|-o CALEA

Descriptorul primei versiuni de bibliotecă (veche). Poate fi una dintre următoarele:

1. Arhivă Java (*.jar) 2. Descriptor XML (fișier VERSION.xml):



1.0





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

...



...

3. Dump API generat de - haldă opțiunea 4. Director cu arhive Java 5. Virgulă
listă separată de arhive Java 6. Listă de directoare separate prin virgulă cu Java
Arhive

Dacă utilizați 1, 4-6 tipuri de descriptori, atunci ar trebui să specificați numerele de versiune
cu -v1 și -v2 opțiuni.

Dacă utilizați *.jar ca descriptor, atunci instrumentul va încerca să obțină implementare
versiunea din fișierul MANIFEST.MF.

-d2|-new|-n PATH

Descriptorul celei de-a doua (noue) versiuni de bibliotecă.

EXTRA OPȚIUNI:
-client|-aplicație PATH

Această opțiune permite specificarea clientului Java ARchive care ar trebui verificat
portabilitate la noua versiune de bibliotecă.

-binar

Afișați numai problemele de compatibilitate „Binară”. Generați raport către
„bin_compat_report.html”.

-sursă

Afișați numai problemele de compatibilitate „Sursă”. Generați raport către
„src_compat_report.html”.

-v1|-versiunea 1 NUM

Specificați prima versiune API în afara descriptorului. Această opțiune este necesară dacă aveți
a preferat un tip de descriptor alternativ (vezi -d1 opțiune).

În general, ar trebui să îl specificați în descriptorul XML:



VERSIUNE



-v2|-versiunea 2 NUM

Specificați a doua versiune de bibliotecă în afara descriptorului.

-s|-strict

Tratați toate avertismentele de compatibilitate API ca probleme.

-a păstra-internă

Nu omite verificarea acestor pachete:

*impl* *intern* *example* *com.oracle* *com.sun* *COM.rsa* *sun* *sunw*

-sărire-internă MODEL

Nu verificați pachetele interne care corespund modelului.

- haldă|-dump-api PATH

Transferați API-ul bibliotecii în fișierul în format TXT comprimat cu gzip. Îl poți transfera oriunde și poți trece
în locul descriptorului. De asemenea, poate fi folosit pentru depanarea instrumentului. Compatibil
versiuni de descărcare: 1.0<=V<=1.0

-lista-clase PATH

Această opțiune permite specificarea unui fișier cu o listă de clase care ar trebui verificate,
alte clase nu vor fi verificate.

-lista-adnotări PATH

Specifică un fișier cu o listă de adnotări. Instrumentul va verifica numai clasele
adnotate prin adnotările din această listă. Alte clase nu vor fi verificate.

-skip-depreciat

Omiteți analiza metodelor și claselor depreciate.

-a lipsi de la cursuri PATH

Această opțiune permite specificarea unui fișier cu o listă de clase care nu ar trebui să fie
verificate.

-salta-pachete PATH

Această opțiune permite specificarea unui fișier cu o listă de pachete care nu ar trebui să fie
verificate.

-mic de statura PATH

Generați un raport scurt fără secțiunea „Metode adăugate”.

-cale-raport PATH

Calea către raportul de compatibilitate. Mod implicit:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

-bin-report-path PATH

Calea către raportul de compatibilitate „Binar”. Mod implicit:

compat_reports/LIB_NAME/V1_to_V2/bin_compat_report.html

-src-raport-cale PATH

Calea către raportul de compatibilitate „Sursă”. Mod implicit:

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-rapid

Analiză rapidă. Dezactivat:

- analiza numelor parametrilor metodei - analiza valorilor câmpului de clasă - analiza
utilizarea metodelor abstracte adăugate - distincția dintre metode și clase depreciate

-fel

Activați sortarea datelor în depozitele API.

-show-access

Afișați nivelul de acces al metodelor non-publice enumerate în raport.

-ascunde-şabloane

Ascundeți parametrii șablonului în raport.

-ascunde-pachete

-minim

Nu face nimic.

-pachete-show

Afișați numele pachetelor în raport.

-limita-afectata LIMITĂ

Numărul maxim de metode afectate enumerate în descrierea modificărilor
introduceți raportul.

ALTE OPȚIUNI:
-Test

Rulați teste interne. Creați două versiuni incompatibile ale unei biblioteci de mostre și rulați
instrumentul pentru a le verifica compatibilitatea. Această opțiune vă permite să verificați dacă instrumentul
funcționează corect în mediul actual.

- depanare

Mod de depanare. Tipăriți informațiile de depanare pe ecran. Salvați etapele intermediare de analiză
în directorul de depanare:

depanare/LIB_NAME/VER/

Luați în considerare și utilizarea - haldă opțiune pentru depanarea instrumentului.

-titlu NUME

Schimbați numele bibliotecii din titlul raportului în NAME. În mod implicit va fi afișat a
nume specificat de -l opțiune.

-jdk-path PATH

Calea către arborele de instalare JDK (de ex /usr/lib/jvm/java-7-openjdk-amd64).

RAPORT:
Raportul de compatibilitate va fi generat pentru:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

EXIT CODURI:
0 - Compatibil. Instrumentul a rulat fără erori. non-zero - Incompatibil sau
instrumentul a rulat cu erori.

MAI MULT INFORMAȚII:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

Utilizați japi-compliance-checker online folosind serviciile onworks.net