Cannot find livekit issue

[AlasalvarOzcan]

AgentforceSDK fails at runtime because LiveKit.framework is missing from embedded frameworks

Description

When integrating AgentforceSDK via CocoaPods, the application builds successfully, but crashes at runtime with a dyld error:

dyld: Library not loaded: @rpath/LiveKit.framework/LiveKit

Referenced from:
.../NetworkProd.app/Frameworks/AgentforceSDK.framework/AgentforceSDK

Reason:
tried:
.../NetworkProd.app/Frameworks/LiveKit.framework/LiveKit
(no such file)

Environment

• Xcode: [version]
• iOS Deployment Target: [version]
• CocoaPods: [version]
• AgentforceSDK: 15.33.5
• AgentforceService: 6.1.3
• AgentforceVoice: 2.1.7
• LiveKitClient: 2.15.1
• LiveKitUniFFI: 0.0.6
• LiveKitWebRTC: 144.7559.10

Steps to reproduce

1. Add AgentforceSDK using CocoaPods:

pod 'AgentforceSDK', '15.33.5'

2. Run:

pod install

3. Build and run the application on iOS Simulator.

Expected behavior

LiveKit.framework should be included in the generated app bundle:

NetworkProd.app/
 └── Frameworks/
     ├── AgentforceSDK.framework
     ├── LiveKit.framework
     ├── LiveKitUniFFI.framework
     └── LiveKitWebRTC.framework

The app should launch successfully.

Actual behavior

AgentforceSDK.framework contains a runtime dependency:

@rpath/LiveKit.framework/LiveKit

confirmed with:

otool -L Pods/AgentforceSDK/AgentforceSDK.xcframework/ios-arm64_x86_64-simulator/AgentforceSDK.framework/AgentforceSDK

Output:

@rpath/LiveKit.framework/LiveKit
@rpath/LiveKitUniFFI.framework/LiveKitUniFFI
@rpath/LiveKitWebRTC.framework/LiveKitWebRTC

However, after CocoaPods installation:

find Pods -name "LiveKit.framework"

returns no result.

The Pods directory only contains:

Pods/LiveKitWebRTC/LiveKitWebRTC.xcframework
Pods/LiveKitUniFFI/RustLiveKitUniFFI.xcframework

but no:

Pods/LiveKitClient/LiveKit.framework

Investigation

Podfile.lock correctly resolves:

LiveKitClient (2.15.1)
  - LiveKitUniFFI (= 0.0.6)
  - LiveKitWebRTC (= 144.7559.10)

However, the LiveKit.framework binary required by AgentforceSDK is not delivered or embedded into the final application.

This suggests one of the following:

1. The AgentforceSDK podspec declares a dependency on LiveKitClient, but the required LiveKit.framework is not exposed through the podspec.
2. The LiveKitClient podspec/package does not correctly declare its vendored framework.
3. CocoaPods integration is missing an embed phase entry for LiveKit.framework.

Additional information

AgentforceSDK.framework binary architectures:

arm64
x86_64

Both architectures contain the same dependency:

@rpath/LiveKit.framework/LiveKit

Request

Could you please verify the AgentforceSDK CocoaPods specification and dependency packaging?

Specifically:

• Is LiveKit.framework expected to be provided by LiveKitClient?
• Should AgentforceSDK's podspec explicitly include LiveKit.framework as a vendored framework dependency?
• Is there a recommended CocoaPods configuration to ensure LiveKit.framework is copied into the application bundle?

Thank you.

[mzaklama]

Hey @AlasalvarOzcan , ran into this exact same crash a while back. Not a maintainer so take this with a grain of salt, but here's the workaround that's been working for me. 👇

TL;DR — the LiveKitClient pod builds LiveKitClient.framework, but Agentforce is looking for LiveKit.framework. Different name, so dyld can't find it at launch. The fix is to rename the pod's product/module to LiveKit and patch up the files CocoaPods generates.

The fix

Drop this into your Podfile (swap <YOUR_TARGET> for your app target name):

post_install do |installer|
  installer.pods_project.targets.each do |target|
    next unless target.name == 'LiveKitClient'
    target.build_configurations.each do |config|
      config.build_settings['PRODUCT_NAME']        = 'LiveKit'
      config.build_settings['PRODUCT_MODULE_NAME'] = 'LiveKit'
    end
  end
end

# The frameworks .sh / xcfilelists get written during integration (after post_install),
# so they need patching here.
post_integrate do |installer|
  sandbox_root = installer.sandbox.root
  support_dir  = File.join(sandbox_root, 'Target Support Files', 'Pods-<YOUR_TARGET>')

  patch = lambda do |path, subs|
    return unless File.file?(path)
    text = File.read(path); orig = text.dup
    subs.each { |from, to| text = text.gsub(from, to) }
    File.write(path, text) unless text == orig
  end

  Dir.glob(File.join(support_dir, 'Pods-<YOUR_TARGET>.*.xcconfig')).each do |xc|
    patch.call(xc, [
      ['-framework "LiveKitClient"', '-framework "LiveKit"'],
      ['LiveKitClient/LiveKitClient.framework', 'LiveKitClient/LiveKit.framework'],
    ])
  end

  Dir.glob(File.join(support_dir, '*')).each do |path|
    next unless File.file?(path) && File.basename(path).include?('frameworks')
    patch.call(path, [['LiveKitClient/LiveKitClient.framework', 'LiveKitClient/LiveKit.
  end

  patch.call(File.join(sandbox_root, 'Target Support Files', 'LiveKitClient', 'LiveKitClient.modulemap'),
             [['framework module LiveKitClient', 'framework module LiveKit']])
end

Run pod install after and LiveKit.framework should show up in …/Frameworks/ — cra

[asikora-sf]

Hi! Yes as of right now we have to do a conversion due to SPM and Cocoapods versions of LiveKit having a different name. I need to update the readme with the updated steps. Thanks for jumping in @mzaklama I'll make sure to update the docs next week.