Cobrowse.io Docs
HomeProductDemoPricing
Search…
Getting started
SDK Installation
Web
iOS
Android
React Native
Xamarin
MacOS
Windows
SDK Features
Account config
Identify your devices
Use 6-digit codes
Redact sensitive data
Customize the interface
Initiate sessions with push
Listening for events
Full device capabilities
Advanced configuration
Agent-side integrations
Agent-side overview
Platform integrations
Custom integrations
Agent SDK
Authentication (JWTs)
Authentication (SAML 2.0)
IFrame embeds
Enterprise self-hosting
Self-hosting overview
Docker Compose
Helm chart
AWS terraform
Azure terraform
GCP terraform
Sizing guidelines
Running your instance
Monitoring your instance
Advanced configuration
Troubleshooting
Powered By GitBook
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
Pods
Carthage
Manual
https://github.com/cobrowseio/cobrowse-sdk-ios-binary.git
pod 'CobrowseIO', '~>2'
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.
github "cobrowseio/cobrowse-sdk-ios-binary" ~> 2.0
Don't forget to run carthage update after you've edited your Cartfile.
More information about Carthage at https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos.
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
Objective-C
import CobrowseIO
...
​
CobrowseIO.instance().license = "put your license key here"
CobrowseIO.instance().start()
@import CobrowseIO;
...
​
CobrowseIO.instance.license = @"put your license key here";
[CobrowseIO.instance start];

Registering on startup

If you would like your devices to register as soon as your app starts, we recommend doing this in your app delegate application:didFinishLaunchingWithOptions: method. For example:
Swift
Objective-C
import CobrowseIO
​
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool
{
CobrowseIO.instance().license = "put your license key here"
CobrowseIO.instance().start()
return true
}
@import CobrowseIO;
​
- (BOOL)application:(UIApplication*) application didFinishLaunchingWithOptions:(NSDictionary*) launchOptions
{
CobrowseIO.instance.license = @"put your license key here";
[CobrowseIO.instance start];
return YES;
}

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 11.0 or later

Flutter Support

There is a community-built Flutter plugin: https://github.com/robodigital/cobrowseio_flutter.

Problems rendering certain views?

Try our alternative rendering method below:

Adding custom touch handlers

Any questions at all? Please email us at [email protected].
SDK Installation - Previous
Web
Next - SDK Installation
Android
Last modified 8d ago
Copy link
On this page
Installation
Add your License Key
Try it out
Requirements
Flutter Support
Problems rendering certain views?
Adding custom touch handlers