japi-compliance-checker: en línea en la nube

PROGRAMA:

NOMBRE

japi-compliance-checker: comprueba la compatibilidad con versiones anteriores de una API de biblioteca de Java

DESCRIPCIÓN

NOMBRE:
Verificador de cumplimiento de la API de Java (japi-compliance-checker) Verifique la compatibilidad con versiones anteriores
de una API de biblioteca Java

DESCRIPCIÓN:
Verificador de cumplimiento de API de Java (Java ACC) es una herramienta para verificar hacia atrás
compatibilidad binaria / fuente de una API de biblioteca Java. La herramienta verifica las clases.
declaraciones de versiones antiguas y nuevas y analiza los cambios que pueden fallar
compatibilidad: miembros eliminados de la clase, métodos abstractos agregados, etc.
La compatibilidad binaria puede provocar fallos o un comportamiento incorrecto de los
clientes construidos con una versión anterior de una biblioteca si se ejecutan con una nueva. Rotura
de la compatibilidad de la fuente puede resultar en errores de recompilación con una nueva biblioteca
versión.

Java ACC está destinado a desarrolladores de bibliotecas y mantenedores de sistemas operativos que
están interesados ​​en garantizar la compatibilidad con versiones anteriores (es decir, permitir que los clientes antiguos se ejecuten o
volver a compilar con una nueva versión de una biblioteca).

Esta herramienta es software libre: puedes redistribuirla y / o modificarla bajo la
términos de GNU LGPL o GNU GPL.

USO:
japi-compliance-checker [opciones]

Ejemplo:
japi-compliance-checker ANTIGUO.jar NUEVO.jar

OR

verificador-de-cumplimiento-japi -lib NOMBRE -antiguo VIEJO.xml -nuevo NEW.xml OLD.xml y NEW.xml son
Descriptores XML:



1.0





/ ruta1 / a / JAR (s) / / ruta2 / a / JAR (s) / ...



INFORMACIÓN: OPCIONES:
-h| -ayuda

Imprime esta ayuda.

-v| -versión

Imprime la información de la versión.

-Dumpversion

Imprima la versión de la herramienta (1.4.3) y no haga nada más.

GENERAL OPCIONES:
-l| -lib | -library NAME

Nombre de la biblioteca (sin versión).

-d1| -old | -o RUTA

Descriptor de la 1ª versión (antigua) de la biblioteca. Puede ser uno de los siguientes:

1. Java ARchive (* .jar) 2. XML-descriptor (archivo VERSION.xml):



1.0





/ ruta1 / a / JAR (s) / / ruta2 / a / JAR (s) /

...



...

3. Volcado de API generado por -tugurio opción 4. Directorio con Java ARchives 5. Coma
lista separada de archivos Java ARchives 6. Lista separada por comas de directorios con Java
Archivo

Si utiliza 1, 4-6 tipos de descriptores, debe especificar los números de versión.
con -v1 y -v2 opciones también.

Si está utilizando * .jar como descriptor, la herramienta intentará implementarlo
versión del archivo MANIFEST.MF.

-d2| -nuevo | -n RUTA

Descriptor de la 2da (nueva) versión de la biblioteca.

EXTRA OPCIONES:
-cliente| -app PATH

Esta opción permite especificar el cliente Java ARchive que se debe verificar.
portabilidad a la nueva versión de la biblioteca.

-binario

Muestra solo los problemas de compatibilidad "binarios". Generar informe para
"bin_compat_report.html".

-Fuente

Mostrar solo los problemas de compatibilidad de "Fuente". Generar informe para
"src_compat_report.html".

-v1| -versión1 NUM

Especifique la primera versión de API fuera del descriptor. Esta opción es necesaria si tiene
prefirió un tipo de descriptor alternativo (ver -d1 opción).

En general, debe especificarlo en el descriptor XML:



VERSION



-v2| -versión2 NUM

Especifique la segunda versión de la biblioteca fuera del descriptor.

-s| -estricto

Trate todas las advertencias de compatibilidad de API como problemas.

-mantener-interno

No omita la verificación de estos paquetes:

* impl * * interno * * ejemplos * * com.oracle * * com.sun * * COM.rsa * * sun * * sunw *

-salto-interno PATRÓN

No verifique los paquetes internos que coincidan con el patrón.

-tugurio| -dump-api RUTA

Volcar la API de la biblioteca en un archivo de formato TXT comprimido con gzip. Puedes transferirlo a cualquier lugar y pasar
en lugar del descriptor. También se puede utilizar para depurar la herramienta. Compatible
versiones de volcado: 1.0 <= V <= 1.0

-lista-de-clases TRAYECTORIA

Esta opción permite especificar un archivo con una lista de clases que se deben verificar,
no se comprobarán otras clases.

-lista-de-anotaciones TRAYECTORIA

Especifica un archivo con una lista de anotaciones. La herramienta verificará solo las clases.
anotado por las anotaciones de esta lista. No se comprobarán otras clases.

-skip-obsoleto

Omita el análisis de métodos y clases obsoletos.

-saltar-clases TRAYECTORIA

Esta opción permite especificar un archivo con una lista de clases que no deben ser
comprobado.

-paquetes-de-saltos TRAYECTORIA

Esta opción permite especificar un archivo con una lista de paquetes que no deben ser
comprobado.

-corto TRAYECTORIA

Genere un informe breve sin la sección "Métodos agregados".

-informe-ruta TRAYECTORIA

Ruta al informe de compatibilidad. Defecto:

compat_reports / LIB_NAME / V1_to_V2 / compat_report.html

-ruta-informe-bin TRAYECTORIA

Ruta al informe de compatibilidad "Binario". Defecto:

compat_reports / LIB_NAME / V1_to_V2 / bin_compat_report.html

-ruta-informe-src TRAYECTORIA

Ruta al informe de compatibilidad "Fuente". Defecto:

compat_reports / LIB_NAME / V1_to_V2 / src_compat_report.html

-rápido

Análisis rápido. Discapacitado:

- análisis de los nombres de los parámetros del método - análisis de los valores de los campos de clase - análisis de
uso de métodos abstractos agregados: distinción de métodos y clases obsoletos

-clasificar

Habilite la clasificación de datos en volcados de API.

acceso al espectáculo

Muestra el nivel de acceso de los métodos no públicos enumerados en el informe.

-Ocultar-plantillas

Ocultar los parámetros de la plantilla en el informe.

-ocultar-paquetes

-Mínima

Hacer nada.

-mostrar-paquetes

Muestra los nombres de los paquetes en el informe.

-limit-afectado LIMITE LAS

El número máximo de métodos afectados enumerados bajo la descripción del cambio
escriba el informe.

OTROS OPCIONES:
-prueba

Realice pruebas internas. Cree dos versiones incompatibles de una biblioteca de muestras y ejecute
la herramienta para comprobar su compatibilidad. Esta opción permite comprobar si la herramienta
funciona correctamente en el entorno actual.

-depurar

Modo de depuración. Imprime la información de depuración en la pantalla. Guardar etapas de análisis intermedias
en el directorio de depuración:

debug / LIB_NAME / VER /

También considere usar -tugurio opción para depurar la herramienta.

-título NOMBRE

Cambie el nombre de la biblioteca en el título del informe a NAME. Por defecto se mostrará un
nombre especificado por -l .

-jdk-ruta TRAYECTORIA

Ruta al árbol de instalación de JDK (p. Ej. / usr / lib / jvm / java-7-openjdk-amd64).

REPORTE:
Se generará un informe de compatibilidad para:

compat_reports / LIB_NAME / V1_to_V2 / compat_report.html

SALIR CODIGOS:
0 - Compatible. La herramienta se ha ejecutado sin errores. distinto de cero: incompatible o
la herramienta se ha ejecutado con errores.

MÁS INFORMACIÓN:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

Use japi-compliance-checker en línea usando los servicios de onworks.net