Install SkyPath iOS SDK

Overview

SkyPath iOS SDK enables your iOS applications to interact with SkyPath using either the Swift or Objective-C programming languages. This page details how to install SkyPath in your project and get started.

Prerequisites

Before getting started, ensure your development environment meets the following prerequisites:

• Xcode version 15.3 or higher.
• A target of iOS 14.0 or higher.

Installation

The SkyPath iOS SDK is provided as a pre-built .xcframework written in Swift.

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.

1. Add Package Dependency

   In Xcode, select File > Add Packages...

2. Specify the Repository

   Copy and paste the following into the search/input box.

   https://github.com/Yamasee/skypath-ios-sdk

3. Specify Options

   In the options for the skypath-ios-sdk package, we recommend setting the Dependency Rule to Up to Next Major Version, and enter the current SkyPath iOS SDK version. Then, click Add Package.

4. Choose Package Products

   Select SkyPathSDK, then click Add Package.

CocoaPods

CocoaPods manages library dependencies for your Xcode projects.

1. Update the CocoaPods repositories

   On the command line, run pod repo update to ensure CocoaPods can access the latest available SkyPath versions.

2. Initialize CocoaPods for Your Project

   If you do not already have a Podfile for your project, run pod init in the root directory of your project to create a Podfile for your project. A Podfile allows you to specify project dependencies to CocoaPods.

3. Add SkyPath as a Dependency in Your Podfile

   platform :ios, '14.0'
   
   target 'Project' do
     # Comment the next line if you don't want to use dynamic frameworks
     use_frameworks!
         
     pod 'SkyPath'
     
   end

4. Install the Dependencies

   From the command line, run pod install to fetch the dependencies.

5. Use the CocoaPods-Generated .xcworkspace File

   CocoaPods generates an .xcworkspace file for you. This file has all of the dependencies configured. From now on, open this file -- not the .xcodeproj file -- to work on your project.

Static Framework

Install the SkyPath SDK as a static framework.

1. Download and Extract the Framework

   Download the latest release of SkyPath and extract the zip.

2. Copy Framework Into Your Project

   Drag SkyPathSDK.xcframework to the File Navigator of your Xcode project. Select the Copy items if needed checkbox and press Finish.

3. Link Binaries

   Select your project in the Xcode File Navigator. Select your app's target and go to the General tab. Under Frameworks, Libraries, and Embedded Content tap Add items, and choose a SkyPathSDK.xcframework file. Make sure the added framework Embed value is set to Embed & Sign.

4. Add the geos library to the project of the version specified in the dependencies of Package.swift. It is used by the SDK for geo operations. In the project target's "General" tap, in the "Frameworks, Libraries, and Embedded Content" set geos as Embed & Sign.

Import SkyPath

Add the following line at the top of your source files to use SkyPath:

import SkyPathSDK

Background Mode

Location will be used while the app is in the background to keep track of and alert to turbulence.

1. Add Location Updates Background Mode

   Select your project in the Xcode File Navigator. Select your app's target and go to the Signing & Capabilities tab. Press Add Capability and choose Background Modes. Under Background Modes now select Location Updates.

2. Open Info.plist file of the project and add Privacy - Location When In Use Usage Description

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location will be used to accurately report and get notified on turbulence ahead</string>

App Download File Size

SkyPathSDK adds around 10 MB to your app's download size.

The releases we distribute are significantly larger because they include support for the iOS simulator which is stripped by the App Store automatically when apps are downloaded.