japi-compliance-checker - En ligne dans le Cloud

PROGRAMME:

Nom

japi-compliance-checker - Vérifier la compatibilité descendante d'une API de bibliothèque Java

DESCRIPTION

NOM:
Vérificateur de conformité de l'API Java (japi-compliance-checker) Vérifier la rétrocompatibilité
d'une API de bibliothèque Java

DESCRIPTION:
Java API Compliance Checker (Java ACC) est un outil de vérification en amont
compatibilité binaire/source d'une API de bibliothèque Java. L'outil vérifie les classes
déclarations d'anciennes et de nouvelles versions et analyse les modifications susceptibles de casser
compatibilité : suppression des membres de la classe, ajout de méthodes abstraites, etc.
la compatibilité binaire peut entraîner un plantage ou un comportement incorrect de l'existant
clients construits avec une ancienne version d'une bibliothèque s'ils fonctionnent avec une nouvelle. Rupture
de la compatibilité de la source peut entraîner des erreurs de recompilation avec une nouvelle bibliothèque
version.

Java ACC est destiné aux développeurs de bibliothèques et aux mainteneurs de systèmes d'exploitation qui
sont intéressés à assurer la rétrocompatibilité (c'est-à-dire permettre aux anciens clients de s'exécuter ou
à recompiler avec une nouvelle version d'une bibliothèque).

Cet outil est un logiciel libre : vous pouvez le redistribuer et/ou le modifier sous le
termes de la GNU LGPL ou de la GNU GPL.

UTILISATION:
vérificateur de conformité japi [options]

Exemple:
vérificateur de conformité japi OLD.jar NEW.jar

OR

vérificateur-de-conformité-japi -lib Nom -vieux ANCIEN.xml -Nouveau NEW.xml OLD.xml et NEW.xml sont
Descripteurs XML :



1.0





/chemin1/vers/JAR(s)/ /chemin2/vers/JAR(s)/ ...



INFORMATION OPTIONS :
-h|-aide

Imprimez cette aide.

-v|-version

Imprimer les informations sur la version.

-version de vidage

Imprimez la version de l'outil (1.4.3) et ne faites rien d'autre.

GÉNÉRAL OPTIONS :
-l|-lib|-library NOM

Nom de la bibliothèque (sans version).

-d1|-old|-o CHEMIN

Descripteur de la 1ère (ancienne) version de la bibliothèque. Il peut s'agir de l'un des éléments suivants :

1. Java ARchive (*.jar) 2. Descripteur XML (fichier VERSION.xml) :



1.0





/chemin1/vers/JAR(s)/ /chemin2/vers/JAR(s)/

...



...

3. Dump API généré par -déverser option 4. Répertoire avec Java ARchives 5. Virgule
liste séparée des ARchives Java 6. Liste des répertoires séparés par des virgules avec Java
Les archives

Si vous utilisez 1, 4-6 types de descripteurs, vous devez spécifier les numéros de version
avec -v1 et -v2 options aussi.

Si vous utilisez *.jar comme descripteur, l'outil essaiera d'obtenir l'implémentation
version du fichier MANIFEST.MF.

-d2|-new|-n CHEMIN

Descripteur de la 2e (nouvelle) version de la bibliothèque.

EXTRA OPTIONS :
-client|-APP CHEMIN

Cette option permet de spécifier le client Java ARchive qui doit être vérifié
portabilité vers la nouvelle version de la bibliothèque.

-binaire

Afficher uniquement les problèmes de compatibilité « binaires ». Générer un rapport à
"bin_compat_report.html".

-source

Afficher uniquement les problèmes de compatibilité « Source ». Générer un rapport à
"src_compat_report.html".

-v1|-version1 NOMBRE

Spécifiez la 1ère version de l'API en dehors du descripteur. Cette option est nécessaire si vous avez
préféré un autre type de descripteur (voir -d1 option).

En général, vous devez le spécifier dans le descripteur XML :



VERSION



-v2|-version2 NOMBRE

Spécifiez la 2e version de la bibliothèque en dehors du descripteur.

-s|-strict

Traitez tous les avertissements de compatibilité API comme des problèmes.

-garder-interne

Ne sautez pas la vérification de ces packages :

*impl* *interne* *exemples* *com.oracle* *com.sun* *COM.rsa* *sun* *sunw*

-sauter-interne RECONNAISSANCE

Ne vérifiez pas les packages internes correspondant au modèle.

-déverser|-dump-api CHEMIN

Videz l'API de la bibliothèque dans un fichier au format TXT compressé. Vous pouvez le transférer n'importe où et passer
au lieu du descripteur. Il peut également être utilisé pour le débogage de l'outil. Compatible
versions de vidage : 1.0<=V<=1.0

-classes-liste PATH

Cette option permet de spécifier un fichier avec une liste de classes à vérifier,
les autres classes ne seront pas vérifiées.

-liste-annotations PATH

Spécifie un fichier avec une liste d'annotations. L'outil ne vérifiera que les classes
annoté par les annotations de cette liste. Les autres classes ne seront pas vérifiées.

-sauter-déprécié

Ignorez l'analyse des méthodes et classes déconseillées.

-sécher les cours PATH

Cette option permet de spécifier un fichier avec une liste de classes qui ne doivent pas être
vérifié.

-sauter-les forfaits PATH

Cette option permet de spécifier un fichier avec une liste de packages qui ne doivent pas être
vérifié.

-court PATH

Générez un rapport court sans section « Méthodes ajoutées ».

-chemin-rapport PATH

Chemin d'accès au rapport de compatibilité. Défaut:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

-bin-chemin-de-rapport PATH

Chemin d'accès au rapport de compatibilité « binaire ». Défaut:

compat_reports/LIB_NAME/V1_to_V2/bin_compat_report.html

-src-chemin-du-rapport PATH

Chemin d'accès au rapport de compatibilité "Source". Défaut:

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-rapide

Analyse rapide. Désactivée:

- analyse des noms de paramètres de méthode - analyse des valeurs des champs de classe - analyse des
utilisation de méthodes abstraites ajoutées - distinction des méthodes et classes dépréciées

-sorte

Activez le tri des données dans les vidages d'API.

-afficher-accès

Afficher le niveau d'accès des méthodes non publiques répertoriées dans le rapport.

-masquer-les-modèles

Masquer les paramètres du modèle dans le rapport.

-cacher-paquets

Minime

Ne fais rien.

-forfaits-spectacles

Afficher les noms des packages dans le rapport.

-limité-affecté LIMIT

Le nombre maximum de méthodes affectées répertoriées sous la description de la modification
taper dans le rapport.

AUTRES OPTIONS :
-tester

Exécutez des tests internes. Créez deux versions incompatibles d'un exemple de bibliothèque et exécutez
l'outil pour vérifier leur compatibilité. Cette option permet de vérifier si l'outil
fonctionne correctement dans l'environnement actuel.

-déboguer

Mode de débogage. Imprimer les informations de débogage à l'écran. Enregistrer les étapes d'analyse intermédiaires
dans le répertoire de débogage :

débogage/LIB_NAME/VER/

Pensez également à utiliser -déverser option de débogage de l'outil.

-Titre Nom

Remplacez le nom de la bibliothèque dans le titre du rapport par NAME. Par défaut sera affiché un
nom spécifié par -l option.

-jdk-chemin PATH

Chemin d'accès à l'arborescence d'installation du JDK (par exemple /usr/lib/jvm/java-7-openjdk-amd64).

RAPPORT:
Le rapport de compatibilité sera généré pour :

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

EXIT CODES:
0 - Compatible. L'outil a fonctionné sans aucune erreur. non nul - Incompatible ou
l'outil a fonctionné avec des erreurs.

AUTRES INFORMATION:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

Utilisez japi-compliance-checker en ligne à l'aide des services onworks.net