在常规iOS应用中使用j2objc生成的静态库遇未定义符号错误

问题场景 #

我通过j2objc将Java SDK转换为iOS静态库，额外编写了Objective-C封装类SdkLiteInterface供客户端调用：

@implementation SdkLiteInterface
+ (void) initSdkIOS {
    ComInterfacomSdkTaximeterTaximeterSdk_init__();
    jboolean started = ComInterfacomSdkTaximeterTaximeterSdk_isStarted();
    NSLog(@"DEBUG SDK TaximeterSdkLiteLib initSdkIOS started = %i", started);
}

静态库项目可正常编译生成.a文件，但在测试应用中调用以下代码时：

#import "SdkLiteInterface.h"
[SdkLiteInterface initSdkIOS];

出现未定义符号错误：

_ComInterfacomSdkTaximeterTaximeterSdk_init__, referenced from:
    +[SdkLiteInterface initSdkIOS] in libTaximeterSdkLiteLib.a[2](SdkLiteInterface.o)
_ComInterfacomSdkTaximeterTaximeterSdk_isStarted, referenced from:
    +[SdkLiteInterface initSdkIOS] in libTaximeterSdkLiteLib.a[2](SdkLiteInterface.o)

已引入SdkLiteInterface.h，但无法定位这些方法，需明确是否需要在应用中配置构建规则，以及常规iOS应用如何使用j2objc生成的静态库。

问题原因 #

这些未定义符号是j2objc转换Java方法后生成的C函数，核心问题在于：

• 静态库项目未将j2objc转换生成的目标文件（或其编译产物）合并到最终输出的.a文件中
• 测试应用未正确链接j2objc核心依赖库及转换后的业务库

解决步骤 #

1. 检查静态库项目的编译打包配置 #

• 确认j2objc转换生成的所有.m/.c文件已添加到静态库项目的Build Phases > Compile Sources列表中
• 在Build Phases > Link Binary With Libraries中添加j2objc核心库：libj2objc.a、libjre_emul.a、libicucore.a（这些库位于j2objc安装目录的lib文件夹下）

2. 调整测试应用的链接与路径配置 #

• 将你的业务静态库libTaximeterSdkLiteLib.a和j2objc核心库全部添加到测试应用的Build Phases > Link Binary With Libraries中
• 在测试应用的Build Settings > Header Search Paths中添加j2objc的头文件路径，指向j2objc安装目录下的include文件夹
• 在Build Settings > Other Linker Flags中添加-ObjC（处理Category代码）和-lz（j2objc依赖zlib）

3. 验证静态库是否包含目标符号 #

用终端命令检查静态库是否包含缺失的符号（替换为你的架构和库路径）：

nm -arch arm64 libTaximeterSdkLiteLib.a | grep ComInterfacomSdkTaximeterTaximeterSdk_init__

若无输出，说明静态库本身未包含这些符号，需回到静态库项目确认转换后的文件是否被正确编译打包。

4. 优化调用方式（可选） #

j2objc会生成对应Java类的Objective-C封装，建议改用Objective-C语法调用，更符合iOS编码习惯且减少符号问题：

#import "Com/Interfacom/Sdk/Taximeter/TaximeterSdk.h"

+ (void) initSdkIOS {
    [ComInterfacomSdkTaximeterTaximeterSdk init];
    jboolean started = [ComInterfacomSdkTaximeterTaximeterSdk isStarted];
    NSLog(@"DEBUG SDK TaximeterSdkLiteLib initSdkIOS started = %i", started);
}

内容的提问来源于stack exchange，提问作者Joan Cagigal