使用j2objc静态库编译iOS应用时出现Undefined symbol错误

问题背景 #

用j2objc转换Java代码后创建Xcode静态库项目，能正常编译生成iPhone和模拟器的.a文件，但将该静态库加入应用项目并调用方法时，出现链接错误：

ld: Undefined symbols:
OBJC_CLASS$_ComInterfacomSdkTaximeterTaximeterSdk, referenced from:
in libTaximeterSdkLiteLib-simulator.a[x86_64]

手动创建的对外接口类SdkLiteInterface实现如下：

@implementation SdkLiteInterface

+ (void) initSdkIOS {
    ComInterfacomSdkTaximeterTaximeterSdk_init__();    
}

@end

其中ComInterfacomSdkTaximeterTaximeterSdk是j2objc转换生成的类，对应Java类com.interfacom.sdk.taximeter.TaximeterSdk，其Java静态方法init()被转换为TaximeterSdk.m中的void ComInterfacomSdkTaximeterTaximeterSdk_init__()方法：

Java原方法（简化版）：

public synchronized static void init() {
    try {
        // 调用内部方法
    } catch (Exception e) {
        // 日志记录
    }
}

转换后的Objective-C方法（简化版）：

void ComInterfacomSdkTaximeterTaximeterSdk_init__() {
  ComInterfacomSdkTaximeterTaximeterSdk_initialize();
  @synchronized(ComInterfacomSdkTaximeterTaximeterSdk_class_()) {
    @try {
        // 调用内部方法
    }
    @catch (JavaLangException *e) {
        // 日志记录
    }
  }
}

排查及解决建议 #

• 检查静态库编译文件列表：确认静态库项目中，ComInterfacomSdkTaximeterTaximeterSdk对应的.m和.h文件已添加到编译目标，未被标记为"跳过编译"。
• 验证静态库符号完整性：用nm命令检查静态库是否包含缺失符号，执行：

  nm -arch x86_64 libTaximeterSdkLiteLib-simulator.a | grep "_OBJC_CLASS_$_ComInterfacomSdkTaximeterTaximeterSdk"
  

  若无输出，说明该类未被正确编译进静态库。
• 核对j2objc转换参数：确认转换Java代码时参数正确，未遗漏--static等关键参数；同时检查原Java类是否为public修饰，j2objc默认不转换非public类。
• 调整应用项目链接配置：在应用项目Build Settings中，给Other Linker Flags添加-ObjC或-all_load，确保静态库中的符号能被正确加载。
• 确认架构匹配：保证应用项目编译架构与静态库一致，比如模拟器用x86_64、真机用arm64，避免架构不匹配导致符号无法找到。
• 检查头文件引用：确保应用项目正确引用ComInterfacomSdkTaximeterTaximeterSdk的头文件，或静态库的umbrella header中包含该类的声明。

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