Using Cocoapods#

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It has over 30 thousand libraries and is used in over 1.9 million apps. CocoaPods can help you scale your projects elegantly. https://cocoapods.org

List of Ground SDK Pods#

Ground SDK for iOS is splitted into 3 different pods.

GroundSdk: Hi-Level API

ArsdkEngine: Arsdk engine

SdkCore: low level implementation (pre-compiled framework).

Note

Using pods will allow you to download only the API header file and to use a pre-compiled version of all other libraries (Pod SdkCore). If you want to modify some of those libraries, you need to install GroundSdk from the sources (see the corresponding installation guide).

How to use Pods in your project#

Install Cocoapods#

You first need to install CocoaPods. You can find more information here. https://guides.cocoapods.org/using/getting-started.html

$ sudo gem install cocoapods

Install Ground SDK Pods and Demo App#

Clone the demo:

$ git clone https://github.com/Parrot-Developers/pod_groundsdk_demo.git

Navigate to the directory that contains your pod_groundsdk_demo:

$ cd ~/Path/To/Folder/Containing/pod_groundsdk_demo

Install the pods

$ pod install

Now, you can open the groundSdkDemo with the Xcode workspace:

$ open GroundSdkDemo.xcworkspace

image0

Adding Ground SDK Pods in a clean Xcode project#

Be sure Xcode is closed.

Open Terminal and navigate to the directory that contains your appProject:

$ cd ~/Path/To/Folder/Containing/appProject

Next, enter the following command:

$ pod init

This creates a Podfile for your project.

Open the Podfile using Xcode for editing:

$ open -a Xcode Podfile

Replace all content with:

platform :ios, '12.0'

target ' appProject ' do
    use_frameworks!
    pod 'GroundSdk', '~> 7.7'
    pod 'ArsdkEngine', '~> 7.7'
    pod 'SdkCore', '~> 7.7'
end

Save and close the Podfile.

From the same directry, install the pods:

$ pod install

you now have created a new appProject.xcworkspace file and a Pods folder containing Ground SDK pods.