iOS mobile SDK integration: preliminaries

Resource usage

The total size of the iOS mobile SDK ranges from 5 to 30 MB, depending on the dependencies required for your use case. If your app offers calls using Vonage, the total size is approximately 30 MB. If you use LiveKit to provide the call feature in your app, the total size is about 22 MB. Both values include the dependencies required.

When running, the SDK uses about 25 MB of RAM. Initializing the SDK requires an additional 3—4 MB of RAM.

The CPU usage of the SDK depends heavily on which Unblu feature is in use. Operations within the WebView can result in short peaks of up to 5 % CPU usage. For video calls, CPU usage can be 50 % or higher, depending on the number of call participants, and RAM usage can go up to 400 MB.

Network traffic

During initialization, the SDK downloads approximately 0.3 MB of JavaScript files. The SDK also has to download around 2.5 MB of additional resources for the UI. Some of these downloads may be cached on the device, resulting in less network traffic for later uses.

For text messaging, only the message itself and the HTTP request overhead is transmitted.

By default, Unblu transmits an image around five times per second in mobile co-browsing sessions if the content has changed. You can adjust the maximum frame capture rate with the configuration property com.unblu.mobiledevice.iosMaxFpsRate. The size of the image depends on the size of the mobile device’s screen but is typically 5—20 KB large.

In audio and video calls, network traffic depends on the quality of the connection, as both Vonage and LiveKit change the codec based on the network connection.

Swift compatibility

The frameworks Unblu provides are written in Swift, not Objective-C, as Swift is the recommended language for iOS development.

Objective-C

In principle, Swift code can be used in Objective-C, but there are some limitations. For example, enums in Swift need to have a raw type of Int. It therefore isn’t possible simply to use the SDKs in an Objective-C environment.

If your project is formally an Objective-C project, you must convert it to a Swift project that mainly uses Objective-C. You must then wrap the usage of the Unblu SDK in a Swift helper which in turn may be used in Objective-C. Currently Unblu doesn’t provide any Swift helper classes.

Swift versions

In 2014, Apple wrote:

[I]f your project uses frameworks to share code with an embedded extension, you will want to build the frameworks, app, and extensions together. It would be dangerous to rely upon binary frameworks that use Swift—especially from third parties. As Swift changes, those frameworks will be incompatible with the rest of your app. When the binary interface stabilizes in a year or two, the Swift runtime will become part of the host OS and this limitation will no longer exist.

— Apple Swift blog

Swift is ABI stable as of version 5.0, so if your project is running Swift 5.0 or newer, it should be able to interface with the Unblu SDK. If you require a version of the Unblu SDK built with an older version of Swift, contact the Unblu support team.

Unblu aims to provide the iOS SDKs for the newest Swift version.