iOS集成RecaptchaEnterprise报arm64架构未定义符号错误如何解决

问题复现 #

• 集成方式：通过CocoaPods在iOS项目中集成RecaptchaEnterprise SDK，Podfile配置如下：

pod 'RecaptchaEnterprise','17.0.0', :source => "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"

• 异常表现：执行pod install依赖拉取安装成功，但Xcode编译阶段抛出链接错误，核心报错内容：

Undefined symbols for architecture arm64:
"_JSObjectIsFunction", referenced from:
iosguard::IsCallableJSValue(JSValue*) in recaptcha(utils_20e35588790c00941fa61c0ddccd0959.o)
"_JSObjectIsConstructor", referenced from:
iosguard::IsCallableJSValue(JSValue*) in recaptcha(utils_20e35588790c00941fa61c0ddccd0959.o)
"_JSValueGetType", referenced from:
iosguard::GetJSValueType(JSValue*) in recaptcha(utils_20e35588790c00941fa61c0ddccd0959.o)
"_OBJC_CLASS_$_JSValue", referenced from:
objc-class-ref in recaptcha(javascript_executor_15c839bc58faec3ce2d75d61fa34786b.o)
objc-class-ref in recaptcha(native_conversions_906021188aa773e592eb340a130f2626.o)
"_JSValueIsObject", referenced from:
iosguard::IsCallableJSValue(JSValue*) in recaptcha(utils_20e35588790c00941fa61c0ddccd0959.o)
"_OBJC_CLASS_$_JSContext", referenced from:
objc-class-ref in recaptcha(IGDContainer_7c03e8f54879222dddd9c24d310f8237.o)
objc-class-ref in recaptcha(javascript_executor_15c839bc58faec3ce2d75d61fa34786b.o)
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

错误原因 #

所有报错提示缺失的符号，包括JSContext、JSValue类和JSObjectIsFunction这类底层C方法，全部来自iOS系统自带的JavaScriptCore.framework。17.0.0版本的RecaptchaEnterprise SDK内部使用了该框架的能力，但对应版本的podspec没有声明这个系统依赖，CocoaPods不会自动将其加入链接参数，最终触发arm64架构下符号找不到的链接错误。

修复方案 #

二选一即可解决问题：

• 方案1：手动添加系统依赖库
  打开Xcode，选中项目对应的App主target，切换到General标签页，滑动到Frameworks, Libraries, and Embedded Content板块，点击下方+号，搜索JavaScriptCore.framework，选中系统库后添加，库的Status保持默认Required即可。添加完成后按快捷键Shift+Command+K清理编译缓存，重新编译即可通过。
• 方案2：修改Podfile自动配置链接
  不想手动调整Xcode配置的话，直接在Podfile对应项目target的配置块中新增一行配置，保存后重新执行pod install，CocoaPods会自动完成JavaScriptCore库的链接配置，无需手动修改Xcode：

  target '你的项目实际Target名称' do
    # 原有RecaptchaEnterprise配置保留
    pod 'RecaptchaEnterprise','17.0.0', :source => "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"
    # 新增下面这行配置
    pod 'JavaScriptCore'
  end
  

排错提示：如果完成上述操作后依然报相同错误，先检查项目Build Settings中的Other Linker Flags配置，确认没有手动排除JavaScriptCore相关的链接规则，再执行命令rm -rf ~/Library/Developer/Xcode/DerivedData/*清理Xcode全局编译缓存，重启Xcode后重新编译即可。

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