japi-compliance-checker - онлайн в облаке

ПРОГРАММА:

ИМЯ

japi-compliance-checker - проверка обратной совместимости API библиотеки Java.

ОПИСАНИЕ

ИМЯ:
Средство проверки соответствия Java API (средство проверки соответствия японским стандартам) Проверка обратной совместимости
API библиотеки Java

ОПИСАНИЕ:
Средство проверки соответствия Java API (Java ACC) - это инструмент для обратной проверки
двоичная / исходная совместимость API библиотеки Java. Инструмент проверяет классы
объявление старых и новых версий и анализ изменений, которые могут нарушить
совместимость: удалены члены класса, добавлены абстрактные методы и т. д.
двоичная совместимость может привести к сбою или неправильному поведению существующих
клиенты, созданные со старой версией библиотеки, если они работают с новой. Поломка
совместимости исходного кода может привести к ошибкам перекомпиляции с новой библиотекой
версия.

Java ACC предназначен для разработчиков библиотек и специалистов по обслуживанию операционных систем, которые
заинтересованы в обеспечении обратной совместимости (т.е. позволяют старым клиентам работать или
для перекомпиляции с новой версией библиотеки).

Этот инструмент является бесплатным программным обеспечением: вы можете распространять и / или изменять его под
условия GNU LGPL или GNU GPL.

ПРИМЕНЕНИЕ:
japi-compliance-checker [параметры]

Пример:
japi-compliance-checker OLD.jar NEW.jar

OR

проверяющий на соответствие японским нормам -lib ИМЯ -Старый СТАРЫЙ.xml -новый NEW.xml OLD.xml и NEW.xml - это
XML-дескрипторы:



1.0





/ путь1 / к / JAR (-ам) / / путь2 / к / JAR (-ам) / ...



ИНФОРМАЦИЯ ОПЦИИ:
-h| -help

Распечатайте эту справку.

-v| -версия

Информация о версии для печати.

-дампверсия

Распечатайте версию инструмента (1.4.3) и больше ничего не делайте.

ОБЩАЯ ИНФОРМАЦИЯ ОПЦИИ:
-l| -lib | -библиотека ИМЯ

Название библиотеки (без версии).

-d1| -old | -o ПУТЬ

Дескриптор 1-й (старой) версии библиотеки. Это может быть одно из следующих:

1. Java ARchive (* .jar) 2. XML-дескриптор (файл VERSION.xml):



1.0





/ путь1 / к / JAR (-ам) / / путь2 / к / JAR (-ам) /

...



...

3. Дамп API, созданный -дамп вариант 4. Каталог с архивами Java 5. Запятая
разделенный список Java ARchives 6. Список разделенных запятыми каталогов с Java
Архивы

Если вы используете 1, 4-6 типов дескрипторов, вам следует указать номера версий.
-v1 и -v2 варианты тоже.

Если вы используете * .jar в качестве дескриптора, тогда инструмент попытается получить реализацию
версия из файла MANIFEST.MF.

-d2| -new | -n ПУТЬ

Дескриптор 2-й (новой) версии библиотеки.

ЭКСТРА ОПЦИИ:
-клиент| -app ПУТЬ

Эта опция позволяет указать клиентский архив Java ARchive, который следует проверять на наличие
переносимость на новую версию библиотеки.

-двоичный

Показывать только проблемы совместимости "Двоичный". Создать отчет в
"bin_compat_report.html".

-source

Показывать только проблемы совместимости "Исходный код". Создать отчет в
"src_compat_report.html".

-v1| -версия1 ЧИСЛО

Укажите 1-ю версию API вне дескриптора. Эта опция нужна, если у вас есть
предпочел альтернативный тип дескриптора (см. -d1 опция).

В общем случае вы должны указать это в дескрипторе XML:



Версия



-v2| -версия2 ЧИСЛО

Укажите вторую версию библиотеки вне дескриптора.

-s| -строгий

Относитесь ко всем предупреждениям о совместимости API как к проблемам.

-внутренний

Не пропускайте проверку этих пакетов:

* impl * * internal * * примеры * * com.oracle * * com.sun * * COM.rsa * * sun * * sunw *

-скип-внутренний ШАБЛОН

Не проверяйте внутренние пакеты, соответствующие шаблону.

-дамп| -dump-api ПУТЬ

Дамп библиотеки API в сжатый файл формата TXT. Вы можете передать его куда угодно и сдать
вместо дескриптора. Также его можно использовать для отладки инструмента. Совместимый
версии дампа: 1.0 <= V <= 1.0

-классы-список PATH

Эта опция позволяет указать файл со списком классов, которые нужно проверить,
другие классы проверяться не будут.

-аннотации-список PATH

Задает файл со списком аннотаций. Инструмент будет проверять только классы
аннотируется аннотациями из этого списка. Остальные классы проверяться не будут.

-skip-не рекомендуется

Пропустить анализ устаревших методов и классов.

-пропускать занятия PATH

Эта опция позволяет указать файл со списком классов, которые не должны быть
проверено.

-скип-пакеты PATH

Эта опция позволяет указать файл со списком пакетов, которые не должны быть
проверено.

-Short PATH

Сгенерируйте короткий отчет без раздела «Добавленные методы».

-report-путь PATH

Путь к отчету о совместимости. Дефолт:

compat_reports / LIB_NAME / V1_to_V2 / compat_report.html

-bin-путь-отчета PATH

Путь к «двоичному» отчету о совместимости. Дефолт:

compat_reports / LIB_NAME / V1_to_V2 / bin_compat_report.html

-src-report-путь PATH

Путь к отчету о совместимости «Источник». Дефолт:

compat_reports / LIB_NAME / V1_to_V2 / src_compat_report.html

-быстро

Быстрый анализ. Отключено:

- анализ имен параметров метода - анализ значений полей класса - анализ
использование добавленных абстрактных методов - различие устаревших методов и классов

-Сортировать

Включить сортировку данных в дампах API.

-show-доступ

Показать уровень доступа закрытых методов, перечисленных в отчете.

-hide-шаблоны

Скрыть параметры шаблона в отчете.

-hide-пакеты

-минимальных

Ничего не делать.

-show-пакеты

Показывать имена пакетов в отчете.

-предел-затронутый ОГРАНИЧЕНИЯ

Максимальное количество затронутых методов указано под описанием измененного
введите отчет.

ДРУГИЕ ОПЦИИ:
-test

Выполните внутренние тесты. Создайте две несовместимые версии библиотеки образцов и запустите
инструмент для проверки их совместимости. Эта опция позволяет проверить, работает ли инструмент
корректно работает в текущей среде.

-отлаживать

Режим отладки. Распечатать отладочную информацию на экране. Сохранить промежуточные этапы анализа
в каталоге отладки:

отладка / LIB_NAME / VER /

Также рассмотрите возможность использования -дамп возможность отладки инструмента.

-заглавие ИМЯ

Измените имя библиотеки в заголовке отчета на NAME. По умолчанию будет отображаться
имя, указанное -l опцию.

-jdk-путь PATH

Путь к дереву установки JDK (например, / usr / lib / jvm / java-7-openjdk-amd64).

ОТЧЕТ:
Отчет о совместимости будет создан для:

compat_reports / LIB_NAME / V1_to_V2 / compat_report.html

ВЫХОД КОДЫ:
0 - Совместимо. Инструмент работал без ошибок. ненулевое значение - несовместимо или
инструмент работал с ошибками.

ЕЩЁ ИНФОРМАЦИЯ:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

Используйте japi-compliance-checker онлайн с помощью сервисов onworks.net