Flutter에서 Agora SDK 통합 시 발생하는 aosl.xcframework 충돌 해결하기

안녕하세요, 오늘은 Flutter 프로젝트에서 Agora의 여러 SDK를 함께 사용할 때 발생하는 골치 아픈 문제에 대한 해결책을 공유하려고 합니다.

문제 상황

최근 실시간 음성/영상 통화와 채팅 기능을 모두 갖춘 앱을 개발하면서 Agora의 여러 SDK를 함께 사용했습니다

dependencies:
  agora_rtc_engine: ^6.5.0
  agora_rtm: ^2.2.2
  agora_chat_sdk: ^1.3.1+1

그런데 iOS 빌드 시 아래와 같은 오류가 발생했습니다

[!] The 'Pods-Runner' target has frameworks with conflicting names: aosl.xcframework.

 

수시간의 구글링과 삽질 끝에 원인과 해결책을 찾았습니다. ㅜㅜ 

이 오류는 agora_rtc_engine과 agora_rtm SDK가 동일한 이름의 프레임워크(aosl.xcframework)를 포함하고 있어 발생하는 것이었습니다.

해결 방법
Agora 공식 문서를 참고해 iOS의 Podfile을 수정하여 문제를 해결했습니다. 아래는 제가 사용한 해결책입니다.
1. Podfile 수정하기
iOS 폴더의 Podfile에 아래 스크립트를 추가했습니다. 이 스크립트는 Pod 설치 과정에서 중복된 프레임워크를 자동으로 제거합니다.

# RTM과 RTC SDK 충돌 해결을 위한 pre_install 스크립트
pre_install do |installer|
  # AgoraRtm 프레임워크 경로 정의
  rtm_pod_path = File.join(installer.sandbox.root, 'AgoraRtm')
  # aosl.xcframework의 전체 경로
  aosl_xcframework_path = File.join(rtm_pod_path, 'aosl.xcframework')
  # 파일이 존재하는지 확인하고, 있다면 삭제
  if File.exist?(aosl_xcframework_path)
    puts "Deleting aosl.xcframework from #{aosl_xcframework_path}"
    FileUtils.rm_rf(aosl_xcframework_path)
  else
    puts "aosl.xcframework not found, skipping deletion."
  end
end

이 스크립트는 AgoraRtm 패키지에서 aosl.xcframework를 찾아 제거합니다. pre_install 블록은 CocoaPods가 실제로 패키지를 설치하기 전에 실행됩니다.
이게 끝입니다 ㅠㅠ 저처럼 다들 삽질 하지마시길 ... ㅠ