How do I handle issues when integrating the Signaling SDK and Video/Voice SDK simultaneously?

When integrating Signaling SDK version 2.2.0 and above with Video/Voice SDK version 4.5.0 or higher, the following errors may appear in the IDE:

Android
iOS/macOS

com.android.builder.merge.DuplicateRelativeFileException: More than one file was found with OS independent path 'lib/x86/libaosl.so'

Unexpected duplicate tasks
Multiple commands produce <your_app_build_path>/Contents/Frameworks/aosl.framework/Versions/A'

The 'XXX' target has frameworks with conflicting names: aosl.xcframework.

Why this happens

Both Signaling SDK versions 2.2.0 and above and Video/Voice SDK versions 4.5.0 and above use the same library:

Android: libaosl.so
iOS/macOS: aosl.xcframework
Windows: libaosl.dll

As a result, the IDE detects multiple files with the same path during the build process, leading to errors.

Solution

Follow these steps to resolve the issue:

Signaling version 2.2.8 or later

For Signaling SDK version 2.2.8 or later, compare the versions of the aosl libraries used in the Video/Voice SDK and Signaling SDK. Choose the subsequent operations based on the two.

info

You can find the aosl library version for the SDKs in the Video SDK or Voice SDK release notes and Signaling release notes.

Android
iOS/macOS

If the Signaling aosl version is lower, integrate the lite SDK:

_6dependencies { _6 // If you are using RTM SDK version 2.2.8 or later _6 // Replace x.y.z with the specific SDK version number, such as 2.2.8 _6 // You can obtain the latest version number from the release notes. _6 implementation 'io.agora.rtm:rtm-sdk-lite:2.2.8' _6}
If the Signaling aosl version is higher, integrate the latest aosl component and use pickFirst to ensure the higher-version aosl library is prioritized during the build process.

_13android { _13 // ... _13 packagingOptions { _13 pickFirst 'lib/**/libaosl.so' _13 } _13} _13 _13 _13dependencies { _13 implementation 'io.agora.infra:aosl:x.y.z' _13 // implementation RTM sdk _13 // implementation RTC sdk _13}

If the Signaling aosl version is lower, integrate the lite SDK:

_7platform :ios, '11.0' _7target 'Your App' do _7 # If you are using RTM SDK version 2.2.8 or later _7 # Replace x.y.z with the specific SDK version number, such as 2.2.8 _7 # You can obtain the latest version number from the release notes. _7 pod 'AgoraRtm', 'x.y.z', :subspecs => ['RtmKit'] _7end
If the Signaling aosl version is higher, add the following script to your Podfile:

info
The following code uses the Video SDK with the package name AgoraRtcEngine_iOS as an example. Use the actual platform and version for your integration.

_15pre_install do |installer| _15 # Define the path to the RTC framework _15 rtc_pod_path = File.join(installer.sandbox.root, 'AgoraRtcEngine_iOS') _15 _15 # Full path to aosl.xcframework _15 aosl_xcframework_path = File.join(rtc_pod_path, 'aosl.xcframework') _15 _15 # Check if the file exists, and delete it if so _15 if File.exist?(aosl_xcframework_path) _15 puts "Deleting aosl.xcframework from #{aosl_xcframework_path}" _15 FileUtils.rm_rf(aosl_xcframework_path) _15 else _15 puts "aosl.xcframework not found, skipping deletion." _15 end _15end

Signaling version 2.2.2 to 2.2.6

For Signaling SDK versions between 2.2.2 and 2.2.6, compare the versions of the aosl libraries used in the Video/Voice SDK and Signaling SDK, then delete the library file with the lower version.

info

You can find the aosl library version for the SDKs in the Video SDK or Voice SDK release notes and Signaling release notes.

If the version of the aosl library included in the Video/Voice SDK package is lower, delete the outdated library file based on the target platform:

Android: Delete the older-version libaosl.so file from the SDK package.
iOS/macOS: Delete the older-version aosl.xcframework file from the SDK package.
Windows: Delete the older-version libaosl.dll file from the SDK package.

If the version of the aosl library in the Signaling SDK package is lower, integrate the lite SDK, then clean and rebuild your project to resolve the library conflict.

Android
iOS/macOS

// ...
dependencies {
    // If you are using RTM SDK version 2.2.2 to 2.2.6
    // Replace x.y.z with the specific SDK version number, such as 2.2.2
    // You can obtain the latest version number from the release notes.
    implementation 'io.agora:agora-rtm-lite:x.y.z'
}

platform :ios, '11.0'
target 'Your App' do
  # If you are using RTM SDK version 2.2.2 to 2.2.6
  # Replace x.y.z with the specific SDK version number, such as 2.2.2
  # You can obtain the latest version number from the release notes.
  pod 'AgoraRtm', 'x.y.z', :subspecs => ['RtmKit']
end

Signaling versions prior to 2.2.2

If you are using a Signaling SDK version prior to 2.2.2, refer to the following solutions based on your platform.

Android
iOS/macOS
Flutter

Using CDN
1. Manually delete the following files from the SDK package:
- lib/x86/libaosl.so
- lib/x86_64/libaosl.so
- lib/armeabi-v7a/libaosl.so
- lib/arm64-v8a/libaosl.so
1. Rebuild the project
Using Maven
1. Add a packagingOptions block to the android block of your build.gradle file to ensure the first matching native library is prioritized during the build process:
  
  _9android { _9 // ... _9 packagingOptions { _9 pickFirst 'lib/x86/libaosl.so' _9 pickFirst 'lib/x86_64/libaosl.so' _9 pickFirst 'lib/armeabi-v7a/libaosl.so' _9 pickFirst 'lib/arm64-v8a/libaosl.so' _9 } _9}
2. After the Gradle files are synchronized, rebuild the project.

Using CDN
1. Manually delete the libs/aosl.xcframework file from the SDK package.
2. Rebuild the project.
Using Cocoapods
1. Add the following script to the end of your project podfile:
  
  _15pre_install do |installer| _15 # Define the path to the AgoraRtm framework _15 rtm_pod_path = File.join(installer.sandbox.root, 'AgoraRtm') _15 _15 # The full path to `aosl.xcframework` _15 aosl_xcframework_path = File.join(rtm_pod_path, 'aosl.xcframework') _15 _15 # Check if the file exists; delete it if it does. _15 if File.exist?(aosl_xcframework_path) _15 puts "Deleting aosl.xcframework from #{aosl_xcframework_path}" _15 FileUtils.rm_rf(aosl_xcframework_path) _15 else _15 puts "aosl.xcframework not found, skipping deletion." _15 end _15end
2. Run pod install to re-integrate the Signaling and Video/Voice SDK.
3. Rebuild the project.

Select the solution based on your target platform:

Android
1. Add the dependency to the build.gradle file in the project root directory:
  
  _4dependencies { _4api 'io.agora.infra:aosl:1.2.13' _4// ... _4}
2. When integrating through Maven, add a packagingOptions block to the android block of your build.gradle file to ensure the first matching native library is prioritized during the build process:
  
  _9android { _9 // ... _9 packagingOptions { _9 pickFirst 'lib/x86/libaosl.so' _9 pickFirst 'lib/x86_64/libaosl.so' _9 pickFirst 'lib/armeabi-v7a/libaosl.so' _9 pickFirst 'lib/arm64-v8a/libaosl.so' _9 } _9}
3. After the Gradle files are synchronized, rebuild the project.
iOS
1. When integrating via CocoaPods, add the following script to the end of your project's Podfile:
  
  _15pre_install do |installer| _15 # Define the path to the AgoraRtm framework _15 rtm_pod_path = File.join(installer.sandbox.root, 'AgoraRtm') _15 _15 # The full path to `aosl.xcframework` _15 aosl_xcframework_path = File.join(rtm_pod_path, 'aosl.xcframework') _15 _15 # Check if the file exists; delete it if it does. _15 if File.exist?(aosl_xcframework_path) _15 puts "Deleting aosl.xcframework from #{aosl_xcframework_path}" _15 FileUtils.rm_rf(aosl_xcframework_path) _15 else _15 puts "aosl.xcframework not found, skipping deletion." _15 end _15end
2. Run pod install to re-integrate the Signaling and Video/Voice SDK.
3. Rebuild the project.

Why this happens​

Solution​

Signaling version 2.2.8 or later​

Signaling version 2.2.2 to 2.2.6​

Signaling versions prior to 2.2.2​

Why this happens

Solution

Signaling version 2.2.8 or later

Signaling version 2.2.2 to 2.2.6

Signaling versions prior to 2.2.2