Install with pods¶
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
Pods : GroundSdk, ArsdkEngine, SdkCore¶
GroundSdk for iOS mobile applications provides three Pods that can quickly and easily set up any application.
GroundSdk: Parrot Drone SDK - Hi-Level API
ArsdkEngine: Parrot Drone SDK, arsdk based engine
SdkCore: Parrot Drone SDK, low level implementation (pre-compiled framework).
Note
The use of Pods allows you to include only the source of the APIs of GroundSdk iOS and to use a pre-compiled version of all other libraries (Pod SdkCore). These libraries are also provided in Open Source and it is also possible to install a full version of groundSdk with all sources (see the corresponding installation guide).
Use Pods in the demo app or in your project¶
Getting Started¶
You first need to install CocoaPods.
CocoaPods is built with Ruby and it will be installable with the default Ruby available on macOS. You can use a Ruby Version manager, however we recommend that you use the standard Ruby available on macOS unless you know what you’re doing.
Using the default Ruby install will require you to use sudo when installing gems. (This is only an issue for the duration of the gem installation, though.)
$ sudo gem install cocoapods
Install the GroundSdk Demo App and Pods¶
Clone the demo:
$ git clone https://github.com/Parrot-Developers/pod_groundsdk_demo.git
Or download the zip file:
https://github.com/Parrot-Developers/pod_groundsdk_demo/archive/master.zip
Open Terminal and navigate to the directory that contains your pod_groundsdk_demo by using the cd command:
$ cd ~/Path/To/Folder/Containing/pod_groundsdk_demo
Enter the command (be sure to close Xcode before)
$ pod install
Now, you can open the groundSdkDemo with the Xcode workspace: GroundSdkDemo.xcworkspace
Adding Parrot Sdk Pods in a fresh Xcode project¶
You first need to close Xcode.
Open Terminal and navigate to the directory that contains your appProject by using the cd command:
$ 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, '10.0'
target ' appProject ' do
use_frameworks!
pod 'GroundSdk', '~> 1.1.2'
pod 'ArsdkEngine', '~> 1.1.2'
pod 'SdkCore', '~> 1.1.2'
end
Save and close the Podfile.
You now need to tell CocoaPods to install the dependencies for your project. Enter the following command in Terminal, after ensuring you’re still in the directory containing the appProject project and Podfile:
$ pod install
Open the project folder using Finder, and you’ll see CocoaPods created a new appProject.xcworkspace file and a Pods folder !