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
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.6'
pod 'ArsdkEngine', '~> 7.6'
pod 'SdkCore', '~> 7.6'
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.