This article describes the library changes of the Agora RTC SDK for iOS and macOS, and how to upgrade to v3.0.1 from versions with the static library.

If you have integrated the v3.0.0 SDK with the dynamic library, you do not need to reintegrate the SDK.

Library changes

As of v3.0.1, the SDK includes only the dynamic library AgoraRtcKit.framework. You can go to SDK Downloads to download the v3.0.1 SDK. The following table lists the libraries among different versions:

SDK version Library name Library type
v3.0.1 or later AgoraRtcKit Dynamic library
v3.0.0 AgoraRtcKit
  • Dynamic library
  • Static library
  • Earlier than v3.0.0 AgoraRtcEngineKit Static library

    Upgrade from v3.0.0 with static library

    1. Copy AgoraRtcKit.framework from the v3.0.1 SDK to the path of your project and replace the original one.

    2. Open Xcode (take Xcode 11.0 as an example), go to the TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content menu, and click - to remove the following libraries:

    Operating system Library name
    iOS
  • Accelerate.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • libc++.tbd
  • libresolv.tbd
  • SystemConfiguration.framework
  • CoreTelephony.framework
  • CoreML.framework
  • VideoToolbox.framework
  • macOS
  • Accelerate.framework
  • CoreWLAN.framework
  • libc++.tbd
  • libresolv.9.tbd
  • SystemConfiguration.framework
  • VideoToolbox.framework
  • On iOS, CoreTelephony.framework only applies to the Agora Voice SDK, CoreML.framework and VideoToolbox.framework only apply to the Agora Video SDK.
  • On macOS, VideoToolbox.framework only applies to the Agora Video SDK.
    1. Change the Embed attribute of AgoraRtcKit.framework to Embed & Sign.

    Upgrade from versions earlier than v3.0.0

    1. Open Xcode (take Xcode 11.0 as an example), remove AgoraRtcEngineKit.framework from the Navigator.

    2. Go to the TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content menu, and click - to remove the following libraries:

    Operating system Library name
    iOS
  • Accelerate.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • libc++.tbd
  • libresolv.tbd
  • SystemConfiguration.framework
  • CoreTelephony.framework
  • CoreML.framework
  • VideoToolbox.framework
  • macOS
  • Accelerate.framework
  • CoreWLAN.framework
  • libc++.tbd
  • libresolv.9.tbd
  • SystemConfiguration.framework
  • VideoToolbox.framework
  • On iOS, CoreTelephony.framework only applies to the Agora Voice SDK, CoreML.framework and VideoToolbox.framework only apply to the Agora Video SDK.
  • On macOS, VideoToolbox.framework only applies to the Agora Video SDK.
    1. Click +, and then click Add Other... to add AgoraRtcKit.framework of the v3.0.1 SDK.

    2. Change the Embed attribute of AgoraRtcKit.framework to Embed & Sign.