Cobrowse.io Docs
  • Getting started
  • SDK Installation
    • Web
    • iOS
    • Android
    • React Native
    • Flutter
    • .NET Mobile
    • macOS
    • Windows
  • SDK Features
    • Account config
    • Identify your devices
    • Use 6-digit codes
    • Redact sensitive data
    • Viewing PDFs
    • Universal Cobrowse
    • Customize the interface
      • Active session controls
      • 6-digit code screen
      • User consent dialog
      • Remote control consent dialog
      • Full device consent dialog
      • Localization / translation
    • Initiate sessions with push
    • Listening for events
    • Full device capabilities
      • Full device screen sharing
      • Full device remote control
      • Managing full device mode
    • Advanced configuration
      • Starting and stopping the SDK
      • Declaring capabilities
      • Intercepting mobile SDK network requests
      • Web
        • IFrames support
        • IE 11 polyfills
        • Cross-domain session support
        • Ignore Views
      • iOS
        • Alternate render method
        • Custom touch handling
      • Android
        • Backporting TLS to older Android versions
  • Agent-side integrations
    • Agent-side overview
    • Platform integrations
      • Zendesk
      • Salesforce
        • Migrating from legacy to v2
        • Salesforce (Legacy)
      • Genesys
        • Genesys Cloud
        • Engage Workspace Web Edition (WWE)
        • Engage Workspace Desktop Edition (WDE)
      • Intercom
      • Freshworks
      • Talkdesk
      • NICE
    • Custom integrations
    • Agent SDK
      • API Reference
      • Sample code snippets
    • Authentication (JWTs)
      • JWT Policies
    • Authentication (SAML 2.0)
    • IFrame embeds
  • Enterprise self-hosting
    • Self-hosting overview
    • Docker Compose
    • Helm chart
      • Image Pull Secret
      • Environment Variables
      • Optional recording components
      • Pod Annotations
    • AWS terraform
      • AWS metrics configuration
    • Azure terraform
      • Azure metrics configuration
    • GCP terraform
      • GCP metrics configuration
    • Sizing guidelines
    • Running your instance
      • Adding a superuser
      • Limiting account creation
      • Limiting magic link recipients
      • Configuring SMTP
      • Managing your deployment
    • Monitoring your instance
      • Available metrics
      • Self-Hosted Prometheus
    • Advanced configuration
      • Air gap configuration
      • Pin web SDK version
      • L7 firewall configuration
      • Docker proxy configuration
    • Troubleshooting
Powered by GitBook
On this page
  • Installation
  • Add your License Key
  • Try it out
  • Requirements
  • Problems rendering certain views?
  • Adding custom touch handlers

Was this helpful?

  1. SDK Installation

iOS

iOS Native SDK

PreviousWebNextAndroid

Last updated 3 months ago

Was this helpful?

Installation

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

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

Add the CobrowseSDK package dependency to your app target.

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.

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 .

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

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.

import CobrowseSDK
...

CobrowseIO.instance().license = "put your license key here"
CobrowseIO.instance().start()
@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 .

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 to see your device listed. You can click the "Connect" button to initiate a Cobrowse session!

Requirements

  • iOS 12.0 or later

Problems rendering certain views?

Try our alternative rendering method below:

Adding custom touch handlers

Any questions at all? Please email us at .

https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos
https://cobrowse.io/dashboard/settings
https://cobrowse.io/dashboard
Alternate render method
Custom touch handling
hello@cobrowse.io