简介：Java2OP for XE10 是面向 Embarcadero Delphi 开发者的跨语言桥接工具，核心用途是把 Java 的 jar 包转换为 Delphi 可直接引用的 PAS 单元文件，让 Delphi 项目无需重写代码即可调用 Java 类库。它针对 XE10.2 版本做了兼容性优化，适合需要在 Delphi 环境中复用 Java 生态、实现跨平台调用的中高级开发者。资源包共 8 个文件，以 jar、exe、inc、xml、txt、log 等类型为主，其中 jar 为待转换的 Java 类库与转换引擎依赖，exe 为转换主程序，inc 与 xml 提供模板和类映射配置，txt 与 log 则用于说明和转换记录，压缩包整体约 16.4MB。目前已有 258 人学习下载。借助该工具，读者可完成从解析 class 字节码、转换元数据到生成 PAS 文件的完整流程，并参考模板与日志排查类型映射、调用约定等常见问题，快速把 Java 库接入 Delphi 工程。
1. 从 JAR 到 PAS：为什么 java2op 在 XE10 上仍是刚需
如果你正在用 Delphi XE10 做 Android 开发，迟早会撞上一件事：手上有一堆现成的 Java 库（JAR 或 AAR），但 Delphi 不认。你不可能把整个 Java 生态重写一遍，也不该为了调一个支付 SDK 或推送接口就切回 Android Studio。java2op 就是干这个的——它把 JAR 包里的 class 文件解析出来，生成 Delphi 能直接uses的 PAS 桥接单元，让 Object Pascal 代码调用 Java 类就像调用本地对象一样自然。
这个工具在 XE10 时代属于 Embarcadero 随 IDE 附带的命令行工具，放在bin目录下，名字就叫java2op.exe。它解决的不是“能不能调”的问题，而是“怎么少写胶水代码”的问题。适合两类人：一是需要在 Delphi 项目里集成第三方 Java SDK 的 Android 开发者，二是维护老项目、要对接新 JAR 包但不想重写接口层的人。热词里提到的jar2pas、class2pas，本质上说的都是同一件事——把 Java 字节码转成 Pascal 接口声明。
2. java2op 的工作机制与输入准备
2.1 它到底解析了什么
java2op 不是反编译工具，它不生成 Java 源码，也不还原方法体。它做的是读取 JAR 里的.class文件，提取公开的类名、方法签名、字段类型和继承关系，然后按照 JNI 的调用约定，生成对应的 Pascal 类型声明和包装函数。生成的 PAS 单元里你会看到大量JniBridge相关的调用，比如TJNIResolver、_CheckJNI这类运行时支撑代码。
关键点在于：java2op 依赖 Java 的反射信息，但它不执行 Java 代码。所以如果你的 JAR 包混淆过，类名变成a.b.c，生成出来的 PAS 也会是a.b.c，调用时你得自己对照混淆映射表。另外，泛型和注解在转换过程中会丢失部分信息，这是后面避坑章节要重点说的。
2.2 环境准备：JDK 版本与路径
java2op 需要 JDK 才能运行，因为它内部调用了 Java 的类加载机制来读取 class 文件。XE10 时代官方推荐 JDK 1.8，也就是 Java 8。如果你机器上装的是 JDK 11 或更高版本，可能会遇到UnsupportedClassVersionError，因为高版本 JDK 编译的 class 文件格式 java2op 不一定认。
我一般会单独准备一个 JDK 1.8 的目录，不设成系统默认，只在跑 java2op 的时候临时指定。Windows 下可以这样验证：
# 查看当前 java 版本，确认是 1.8 java -version # 如果系统默认不是 1.8，临时切换 JAVA_HOME set JAVA_HOME=C:\jdk1.8.0_202 set PATH=%JAVA_HOME%\bin;%PATH%逻辑说明：java -version输出里如果看到1.8.0_xxx就对了。JAVA_HOME指向 JDK 根目录，不是 JRE 目录。PATH 里把 JDK 的 bin 放在最前面，确保 java2op 调用的是这个版本。
参数上注意：java2op 本身不提供--java-home之类的选项，它直接读环境变量。所以如果你系统里同时有多个 JDK，切换环境变量是最稳妥的做法。
2.3 准备 JAR 包和依赖链
一个 JAR 包往往不是孤立的。比如你拿到的支付 SDK，可能依赖okhttp.jar、gson.jar，这些依赖如果不在 classpath 里，java2op 解析到一半就会报ClassNotFoundException。所以第一步不是急着跑命令，而是先把依赖关系理清楚。
常见做法是：把主 JAR 和所有依赖 JAR 放在同一个目录下，然后用-cp参数把所有 JAR 都加进去。目录结构大概这样：
libs/ main-sdk.jar okhttp-3.x.jar gson-2.x.jar annotations.jar如果 JAR 包里有META-INF/MANIFEST.MF，可以打开看看Class-Path字段，里面会列出它期望的依赖。没有的话，就只能靠报错信息反推——缺哪个类就补哪个 JAR。
3. 命令行实操：从 JAR 生成 PAS 的完整流程
3.1 基本命令与参数拆解
java2op 的命令行参数不算多，但每个都影响生成结果。最常用的形式是这样：
java2op -jar libs\main-sdk.jar -o ..\JNI\Android\main-sdk.pas -cp libs\okhttp-3.x.jar;libs\gson-2.x.jar逐项说明：
-jar：指定要解析的主 JAR 文件，路径可以是相对或绝对。-o：输出 PAS 文件的路径。建议放在 Delphi 项目的JNI\Android目录下，方便统一管理。-cp：classpath，多个 JAR 用分号隔开（Windows）或冒号隔开（macOS/Linux）。这里要把所有依赖 JAR 都列上。
还有一个常用参数-uses，用来指定生成的 PAS 单元里要引用的其他单元。比如你的项目里已经有Androidapi.JNIBridge，就可以加上-uses Androidapi.JNIBridge,Androidapi.JNI.JavaTypes，避免生成重复的桥接代码。
3.2 处理多个 JAR 和包名过滤
实际项目里往往不止一个 JAR。如果每个 JAR 单独生成一个 PAS，单元数量会爆炸。我一般会按功能模块合并：把同一模块的 JAR 放在一起，用-jar指定主 JAR，-cp带上同模块的其他 JAR，生成一个统一的 PAS 单元。
如果 JAR 里包名很多，但你只关心其中几个包，可以用-include和-exclude过滤。比如只想要com.example.payment包下的类：
java2op -jar libs\payment-sdk.jar -o payment.pas -include com.example.payment.*注意：-include的匹配是前缀匹配，com.example.payment.*会包含该包及其子包。-exclude用法类似，用来排除测试类或内部工具类。
3.3 生成结果的结构解读
跑完命令后，打开生成的 PAS 文件，你会看到几块内容：
第一块是接口声明，比如JPackageName_ClassName = interface(JObject)，里面列出了所有公开方法和属性。方法名通常保持 Java 原名，参数类型会映射成对应的 JNI 类型，比如JString、JObjectArray。
第二块是类引用，比如TJClassName = class(TJavaGenericImport<JClassNameClass, JClassName>)，这是 Delphi 里用来获取 Java 类句柄的包装。
第三块是初始化代码，在initialization段里注册类和方法 ID。这部分代码不需要手动改，但如果你发现某个方法调用时报NoSuchMethodError，就要回来检查这里的签名是否和实际 JAR 一致。
提示：生成的 PAS 文件不要手动修改方法签名，因为下次重新生成会被覆盖。如果确实需要调整，建议写一个独立的辅助单元，在运行时做适配。
4. 避坑与排查：java2op 常见的五类翻车现场
4.1 报 ClassNotFoundException 但 JAR 明明在
现象：命令跑起来就报java.lang.ClassNotFoundException: com.xxx.SomeClass，但你确认这个类就在主 JAR 里。
原因：java2op 解析主 JAR 时，遇到它引用的其他类，会去 classpath 里找。如果依赖 JAR 没加进-cp，或者路径写错了，就会报这个错。
解决：先用jar tf列出主 JAR 的内容，确认类确实存在。然后检查-cp里的每个 JAR 路径是否有效，Windows 下注意反斜杠和分号。可以临时把主 JAR 也加到-cp里，虽然理论上不需要，但有时能绕过一些加载顺序问题。
4.2 生成的 PAS 编译报“未声明标识符”
现象：PAS 文件生成成功，但放到 Delphi 项目里编译时，提示某个类型或方法未声明。
原因：通常是-uses参数没配好，生成的单元引用了其他 JNI 单元但没自动加上。或者 JAR 里用到了 Delphi 不支持的 Java 类型，比如某些泛型嵌套。
解决：打开生成的 PAS，看uses子句里缺什么，手动补上。如果是泛型问题，找到对应的方法声明，把泛型参数替换成JObject或具体类型。常见做法是保留原始声明，在调用处做类型转换。
4.3 方法调用时抛 NoSuchMethodError
现象：编译通过，运行时调用某个方法，抛java.lang.NoSuchMethodError。
原因：java2op 生成的方法签名和 JAR 里的实际签名不一致。常见于方法重载、可变参数、或者 JAR 版本和生成时用的版本不同。
解决：用javap -s查看 JAR 里该方法的真实签名，对比 PAS 里的声明。如果发现参数类型不对，比如 Java 的int被映射成了JInteger而不是Integer，就需要在调用时做转换。另外确认生成 PAS 时用的 JAR 和运行时用的 JAR 是同一个版本。
4.4 混淆后的 JAR 生成结果不可读
现象：生成的 PAS 里全是a.a.a、b.b.b这样的类名和方法名，根本没法用。
原因：JAR 被 ProGuard 或类似工具混淆过，原始类名和方法名被替换成了短名称。
解决：找 SDK 提供方要未混淆的版本，或者要混淆映射表（mapping.txt）。如果只有混淆版，那就只能硬着头皮用，但调用时得对照映射表把a.a.a翻译回原始类名。我一般会在项目里单独维护一个映射注释文件，记录每个混淆名对应的业务含义。
4.5 生成的 PAS 文件过大导致编译缓慢
现象：一个 JAR 生成的 PAS 文件几万行，Delphi 编译时明显变慢，甚至内存溢出。
原因：JAR 里包含了大量不需要的类，比如内部工具类、测试类、废弃 API。
解决：用-include只保留业务需要的包，用-exclude排除*.internal.*、*.test.*这类包。如果还是大，可以考虑按功能拆成多个 PAS 单元，每个单元只包含一个模块的类。拆分后记得在项目里按需uses，不要全部引用。
5. 进阶技巧：让 java2op 生成的代码更可控
5.1 用批处理脚本固化生成流程
手动敲命令容易漏参数，尤其是依赖多的时候。我习惯在项目根目录放一个gen-jni.bat，把 java2op 调用固定下来：
@echo off set JAVA_HOME=C:\jdk1.8.0_202 set PATH=%JAVA_HOME%\bin;%PATH% set LIBS=libs set OUT=..\JNI\Android java2op -jar %LIBS%\main-sdk.jar ^ -o %OUT%\main-sdk.pas ^ -cp %LIBS%\okhttp-3.x.jar;%LIBS%\gson-2.x.jar ^ -uses Androidapi.JNIBridge,Androidapi.JNI.JavaTypes ^ -include com.example.sdk.*逻辑说明：^是 Windows 批处理的换行符。JAVA_HOME和PATH在脚本里重新设一遍，避免受系统环境影响。-include限定包名，减少生成体积。每次 JAR 更新后，双击这个脚本就能重新生成，不用记参数。
5.2 验证生成结果是否可用
生成 PAS 只是第一步，真正要确认的是能不能调通。我一般会写一个最小的测试单元，只调用一个最简单的方法，比如获取版本号：
uses Androidapi.JNIBridge, Androidapi.JNI.JavaTypes, main-sdk; // 生成的单元 procedure TForm1.TestSDK; var SDK: JMainSDK; begin SDK := TJMainSDK.JavaClass.init; ShowMessage(SDK.getVersion); end;如果这一步能跑通，说明类加载和方法签名基本正确。如果报错，就回到第 4 章对照排查。注意：测试时要在 Android 真机或模拟器上跑，Windows 下编译通过不代表 Android 运行时没问题。
5.3 处理回调接口和监听器
Java SDK 里经常有回调接口，比如OnPaymentResultListener。java2op 会把它生成一个接口类型，但 Delphi 里实现 Java 接口需要用到TJavaLocal或TJavaObject的派生类。常见做法是：
type TPaymentListener = class(TJavaLocal, JOnPaymentResultListener) public procedure onResult(code: Integer; msg: JString); cdecl; end; procedure TPaymentListener.onResult(code: Integer; msg: JString); begin // 处理回调 end;参数说明：TJavaLocal是 Delphi 提供的本地 Java 对象基类，cdecl调用约定必须加，否则 JNI 调用会崩。方法名和参数类型必须和生成的接口声明完全一致，不能改。
5.4 版本升级时的回归检查清单
JAR 包升级后，不要直接覆盖旧 PAS。我一般会走一遍检查清单：
| 检查项 | 操作 | 目的 |
|---|---|---|
| 类名变化 | 对比新旧 PAS 的接口声明 | 确认没有类被删除或重命名 |
| 方法签名 | 用javap -s抽查关键方法 | 确认参数和返回值类型一致 |
| 依赖变化 | 检查新 JAR 的Class-Path | 确认没有新增未加入-cp的依赖 |
| 回调接口 | 对比监听器方法数量 | 确认没有新增必须实现的方法 |
| 生成体积 | 对比 PAS 行数 | 突然变大可能引入了不需要的包 |
这张表我每次升级 SDK 都会过一遍，花不了几分钟，但能避免上线后才发现接口对不上。
从那以后我每次拿到新 JAR，都强制先跑一遍javap看签名，再用 java2op 生成，最后在真机上跑一个最小调用测试。这三步走完，基本不会出大问题。希望帮到你。
本文还有配套的精品资源，点击获取
