Xcode Project and Workspace

You will be using the iOS Client SDK library inside an Xcode project you'll create next:

Create an Xcode Project

  • Open Xcode and, from the menu, select File > New > Project....

  • Select iOS as platform.

  • Select a App for the Application type and click Next.

  • For the Product Name type in AppToPhone.

  • Select or add the relevant value for Team and Organisation Identifier. NB: If you don't possess that info, select None for Team and enter com.test for Organisation Identifier.

  • Use Storyboard for Interface and Swift for Language.

  • Ensure that both Use Core Data and Include Tests options are deselected. Click Next.

  • Select your project folder, app-to-phone-swift as the place where your Xcode project will reside.

  • You now have a brand new Xcode Project.

IMPORTANT: Before continuing, please close the new project you created.

You will add the iOS Client SDK library to your project via CocoaPods.

Install CocoaPods

  • Open the Terminal app and navigate to Xcode folder inside your project:
cd app-to-phone-swift/AppToPhone
  • Install CocoaPods in your system, if you don't have it already.
sudo gem install cocoapods

Note: CocoaPods is built with Ruby, available by default on macOS.

  • Create a Podfile for your project:
pod init

Add the iOS Client SDK

  • Add the Vonage iOS Client SDK to the Podfile. To do this, let's open it in Xcode:
open -a Xcode Podfile
  • Update the Podfile as shown below.
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'AppToPhone' do
  # Comment the next line if you don't want to use dynamic frameworks

  # Pods for AppToPhone
  pod 'NexmoClient'

  • Install the library.
pod install

The latest version of the library will be added to your project:

Analyzing dependencies
Downloading dependencies
Installing NexmoClient (3.0.0)
Generating Pods project
Integrating client project

[!] Please close any current Xcode sessions and use `AppToPhone.xcworkspace` for this project from now on.
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

[!] Automatically assigning platform `iOS` with version `14.4` on target `AppToPhone` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.

Open the Workspace

As described in the output above, please use AppToPhone.xcworkspace rather than the initial project from now on. To open it, type the following in the terminal:

open AppToPhone.xcworkspace