iOS

iOS Native SDK

Installation

The Cobrowse SDK for iOS is available for installation via several dependency managers, or as frameworks to integrate directly into your project:

SPM

https://github.com/cobrowseio/cobrowse-sdk-ios-binary.git

Add the CobrowseSDK package dependency to your app target.

Pods

CocoaPods will no longer accept pod updates after 2nd December 2026 so Cobrowse cannot publish updates through that platform after this date. We recommend migrating to the Swift Package Manager (SPM) instead.

pod 'CobrowseIO', '~>3'

Don't forget to run pod repo update then pod install after you've edited your Podfile.

Make sure you are on the latest stable version of Pods. Run pod --version to check!

Note: Depending on your project, you may also need use_frameworks! in your Podfile.

Carthage

binary "https://raw.githubusercontent.com/cobrowseio/cobrowse-sdk-ios-binary/master/cobrowse-sdk-ios-binary.json" ~> 3.0

Remember to run carthage update --use-xcframeworks after modifying your Cartfile.

More information about Carthage at https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos.

Link the CobrowseSDK.xcframework to your main app target that can be found at ./Carthage/Build.

Manual

Frameworks are available for manual integration into your Xcode projects from:

https://github.com/cobrowseio/cobrowse-sdk-ios-binary/releases

Add the following lines to your code which will register this device with the Cobrowse servers so you can connect to it. You could choose to do this on app startup, or when your users visits a support page in your application, or any other time.

Swift

import CobrowseSDK
...

CobrowseIO.instance().license = "put your license key here"
CobrowseIO.instance().start()

Objective-C

@import CobrowseSDK;
...

CobrowseIO.instance.license = @"put your license key here";
[CobrowseIO.instance start];

Add your License Key

Please register an account and generate your free License Key at https://cobrowse.io/dashboard/settings.

This will associate sessions from your mobile app with your Cobrowse account.

Try it out

Once you have your app running in the iOS Simulator or on a physical device, navigate to https://cobrowse.io/dashboard to see your device listed. You can click the "Connect" button to initiate a Cobrowse session!

Requirements

• iOS 15.0 or later

Our minimum supported iOS version is always the lowest Apple will accept as an App Store submission.

Problems rendering certain views?

Try our alternative rendering method below:

Alternate render method

Adding custom touch handlers

Custom touch handling

Any questions at all? Please email us at [e-mail].