Install and build GroundSdk

Environment setup

Download and install the latest Xcode from App Store Application

Note

GroundSdk has been successfully tested with Xcode 10.2, Swift 4.2 and Mac OS Mojave 10.14

Install Homebrew

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install the required tools using Homebrew

$ brew install bash-completion git xctool pkgconfig repo python3 cmake autoconf automake libtool

Install the following Python module

$ pip3 install requests

Configure git with your real name and email address

$ git config --global user.name "Your Name"
$ git config --global user.email "you@example.com"

Download GroundSdk

Create your working directory

$ mkdir groundsdk
$ cd groundsdk

Initialize Repo in your working directory

$ repo init -u https://github.com/Parrot-Developers/groundsdk-manifest

Note

You can learn how to use Repo on the command reference page

Download the GroundSdk source tree

$ repo sync

Xcode configuration

Open project to install automatically last components of Xcode

$  open ./products/groundsdk/ios/xcode/groundsdk.xcworkspace/

Connect your Apple developer account and select your provisioning profile

Build and run GroundSdk Demo

  1. Build GroundSdk Demo for iOS device

# the build script will ask you to enter your password session a few times
$ ./build.sh -p groundsdk-ios -t build -j

Note

To know more about building options

$ ./build.sh -p groundsdk-ios -t

Note

Build GroundSdk Demo for Simulator

$ ./build.sh -p groundsdk-ios_sim -t build -j
  1. Connect an iOS device to your computer

  2. Go back to Xcode

  3. Select iOS device

  4. Click on Build and then run the current scheme

Connect to your drone

  1. Switch on your drone

  2. Open wifi settings on your iOS device

  3. Select your drone’s wifi access point (e.g. ANAFI-xxxxxxx)

  4. Enter wifi password

  5. Open Ground SDK Demo app

  6. Your drone should appear in the list, select it

  7. Click on Connect