Installation guide¶
Installation with CocoaPods¶
CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party frameworks or libraries like KurentoToolbox.framework in your projects.
Step 1: Downloading CocoaPods¶
CocoaPods is distributed as a Ruby gem and is installable with the default Ruby available on OSX by running the following command:
$ sudo gem install cocoapods
$ pod setup
Step 2: Creating a Podfile¶
Project dependencies to be managed by CocoaPods are specified in a file called Podfile
. Create this file in the same directory as your Xcode project (.xcodeproj
) file:
$ touch Podfile
$ open -a Xcode Podfile
You just created the pod file and opened it using Xcode, to add some content to the empty pod file copy and paste the following lines:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
pod 'KurentoToolbox', '~> 0.2.4'
Step 3: Installing Dependencies¶
Now you can install the dependencies in your project:
$ pod install
From now on, be sure to always open the generated Xcode workspace (.xcworkspace
) instead of the project file when building your project:
$ open <YourProjectName>.xcworkspace
At this point, everything is in place for you to start using KurentoToolbox. Just :obj-c:`#import` the umbrella header wherever you need to use it, usually in <YourProjectName-Prefix>.pch file:
#import <KurentoToolbox/KurentoToolbox.h>
Manual installation¶
Step 1: Download & unzip the framework¶
Download the latest KurentoToolbox.framework (v0.2.4) below:
Step 2: Add the framework to your Xcode project¶
Drag the KurentoToolbox.framework into your Xcode project. Make sure the “Copy items to destination’s group folder” checkbox is checked.
Step 3: Link Binary With Library Frameworks¶
Click on Project → Select Target of interest → Choose Build Phases tab → Link Binary With Libraries → At the bottom of this list hit + to add libraries.
Here is the list of required Apple library frameworks/dylibs:
libicucore.dylib
libstdc++.dylib
libc.dylib
libsqlite3.dylib
AVFoundation.framework
AudioToolbox.framework
CoreGraphics.framework
CoreMedia.framework
GLKit.framework
UIKit.framework
VideoToolbox.framework
CFNetwork.framework
Security.framework
Step 4: Add -ObjC linker flag¶
Click on Project → Select Target of interest → Choose Build Settings tab → Other Linker Flags and add the -ObjC
linker flag.
Step 5: Importing Header(s)¶
Just :obj-c:`#import` the umbrella header wherever you need to use KurentoToolbox, usually in <YourProjectName-Prefix>.pch file
#import <KurentoToolbox/KurentoToolbox.h>