japi-compliance-checker - 云端在线

程序：

您的姓名

japi-compliance-checker - 检查 Java 库 API 的向后兼容性

商品描述

产品名称：
Java API 合规性检查器 (japi-compliance-checker) 检查向后兼容性
Java 库 API

描述：
Java API Compliance Checker (Java ACC) 是一种用于向后检查的工具
Java 库 API 的二进制/源代码兼容性。 该工具检查类
旧版本和新版本的声明并分析可能会破坏的更改
兼容性：删除类成员，添加抽象方法等。
二进制兼容性可能会导致现有的崩溃或不正确的行为
如果客户端使用新版本运行，则使用旧版本库构建。 破损
源兼容性可能会导致新库的重新编译错误
版。

Java ACC 是为库开发人员和操作系统维护人员准备的
对确保向后兼容性感兴趣（即允许旧客户端运行或
用新版本的库重新编译）。

该工具是免费软件：您可以重新分发和/或修改它
GNU LGPL 或 GNU GPL 的条款。

用法：
japi-compliance-checker [选项]

例：
japi-compliance-checker OLD.jar NEW.jar

OR

japi 合规性检查器 -lib 您的姓名 -旧 旧文件 -新的 NEW.xml OLD.xml 和 NEW.xml 是
XML 描述符：



1.0





/路径1/到/JAR/ /路径2/到/JAR/ ...



相关信息 选项：
-h|-帮助

打印此帮助。

-v|-版本

打印版本信息。

-转储版本

打印工具版本（1.4.3），不要做任何其他事情。

一般 选项：
-l|-lib|-库名称

库名称（无版本）。

-d1|-旧|-o 路径

第一个（旧）库版本的描述符。 它可能是以下之一：

1. Java 存档 (*.jar) 2. XML 描述符（VERSION.xml 文件）：



1.0





/路径1/到/JAR/ /路径2/到/JAR/

...



...

3. API dump 生成 -倾倒 选项 4. 带有 Java 档案的目录 5. 逗号
分隔的 Java 档案列表 6. 逗号分隔的 Java 目录列表
档案

如果您使用 1、4-6 个描述符类型，那么您应该指定版本号
- -v1 和 -v2 选项。

如果您使用 *.jar 作为描述符，那么该工具将尝试获取实现
MANIFEST.MF 文件中的版本。

-d2|-new|-n 路径

第二个（新）库版本的描述符。

额外服务 选项：
-客户|-应用程序路径

此选项允许指定应检查的客户端 Java 存档
可移植到新的库版本。

-二进制

仅显示“二进制”兼容性问题。 生成报告给
“bin_compat_report.html”。

-资源

仅显示“源”兼容性问题。 生成报告给
“src_compat_report.html”。

-v1|-版本1 NUM

在描述符之外指定第一个 API 版本。 如果您有此选项，则需要此选项
首选替代描述符类型（请参阅 -d1 选项）。

在一般情况下，您应该在 XML 描述符中指定它：



VERSION



-v2|-版本2 NUM

在描述符之外指定第二个库版本。

-s|-严格

将所有 API 兼容性警告视为问题。

-保持内部

不要跳过检查这些包：

*impl* *内部* *示例* *com.oracle* *com.sun* *COM.rsa* *sun* *sunw*

-跳过内部 模式

不检查与模式匹配的内部包。

-倾倒|-dump-api 路径

转储库 API 到 gzipped TXT 格式文件。 您可以在任何地方转移并通过
而不是描述符。 它也可用于调试工具。 兼容的
转储版本：1.0<=V<=1.0

-类列表 PATH

此选项允许指定一个文件，其中包含应检查的类列表，
不会检查其他类。

-注释列表 PATH

指定带有注释列表的文件。 该工具将只检查类
由此列表中的注释进行注释。 不会检查其他类。

-跳过-弃用

跳过不推荐使用的方法和类的分析。

- 跳过类 PATH

此选项允许指定一个文件，其中包含不应被添加的类列表
检查。

-跳过包 PATH

此选项允许指定一个文件，其中包含不应包含的包列表
检查。

-短 PATH

生成没有“添加方法”部分的简短报告。

-报告路径 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-报告-路径 PATH

“源”兼容性报告的路径。 默认：

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-快的

快速分析。 禁用：

- 分析方法参数名称 - 分析类字段值 - 分析
添加抽象方法的使用 - 不推荐使用的方法和类的区别

-种类

启用 API 转储中的数据排序。

-显示访问

显示报告中列出的非公共方法的访问级别。

-隐藏模板

在报告中隐藏模板参数。

-隐藏包

-最小

没做什么。

-显示包

在报告中显示包名称。

-限制影响 极限

在更改的描述下列出的受影响方法的最大数量
输入报告。

其他 选项：
-测试

运行内部测试。 创建示例库的两个不兼容版本并运行
检查它们的兼容性的工具。 此选项允许检查工具是否
在当前环境中正常工作。

-调试

调试模式。 在屏幕上打印调试信息。 保存中间分析阶段
在调试目录中：

调试/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

使用 onworks.net 服务在线使用 japi-compliance-checker