iOS SDK

Twilio's Programmable Voice SDK includes client-side SDKs for browser-based web applications and native mobile applications.

The SDKs are released according to semantic versioning, so you should always note both the major and minor versions of the SDKs to maintain API compatibility with your code. For versions 1.0 and higher, minor versions will not break existing integrations, but during the beta period, minor version increments in the 0.x range represent breaking API changes. Patch level releases - 0.0.x - represent non-breaking changes during the beta.

System Requirements

The Twilio Programmable Voice SDK is supported on iOS 8.1 or above.

The Quickstart demo apps are built for Xcode 8 and iOS 10, and require Cocoapods 1.0 or greater.

Install

The iOS Voice framework can be installed using Cocoapods or manually, as you prefer.

Cocoapods Install

It's easy to install the Voice framework if you manage your dependencies using Cocoapods. Simply add the following to your Podfile:

source 'https://github.com/cocoapods/specs'
source 'https://github.com/twilio/cocoapod-specs'

target 'TARGET_NAME' do
  use_frameworks!

  pod 'TwilioVoiceClient', '=2.0.0-beta5'
end

Then run pod install --verbose to install the dependencies to your project.

Manual Install

Voice is distributed as a dynamic iOS framework that you can drag and drop into your existing projects.

Once you've downloaded and unpacked the framework, navigate to your Xcode project's General settings page. Drag and drop TwilioVoiceClient.framework onto the Embedded Binaries section. Ensure that "Copy items if needed" is checked and press Finish. This will add TwilioVoiceClient.framework to both the Embedded Binaries and Linked Frameworks and Libraries sections.

Before distributing your app to the  App Store, you will need to strip the simulator binaries from the embedded framework. Navigate to your target's Build Phases screen and create a new "Run Script Phase". Paste the following command in the script text field:

/bin/bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/TwilioVoiceClient.framework/remove_archs"

We recommend that you start with our Getting Started guide to get a sense of how all these components fit together. The Quickstart app is set up to manage dependencies with Cocoapods, but you can also install the frameworks manually, as described above.