HTTPS SSH

Steerpath iOS SDK

Copyright Steerpath Ltd. 2018. All rights reserved

How to install Steerpath iOS SDK via CocoaPods

  • Install CocoaPods http://cocoapods.org/
  • Create a Podfile in your project root directory and add the following lines:
  source 'https://github.com/CocoaPods/Specs.git'
  source 'https://bitbucket.org/nimbledevices/steerpath-sdk-ios-podspec.git'
  source 'https://bitbucket.org/nimbledevices/steerpath-mapbox-ios-podspec.git'
  use_frameworks!  

  target 'YourAppTargetHere' do
    pod 'Steerpath', '3.5.20'
  end  
  • Navigate to your project root directory and type:
pod install

To do anything meaningful you will need API access to the Steerpath Platform. Currently API access only via request: support@steerpath.com

After receiving your API key, open the .xcworkspace file created in your project root folder.

  • Add the following key into your application Info.plist:
SPSteerpathAccessToken = 'your api key here'
  • Make sure your application Info.plist contains the following 'App Transport Security Settings'.
<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
  <key>NSAllowsLocalNetworking</key>
  <true/>
</dict>

This is done because the SDK is running a local webserver that does not support HTTPS. However all external communications are using HTTPS.

  • Make sure you've linked the following iOS frameworks to your application
CoreLocation.framework
CoreBluetooth.framework
CoreMotion.framework
  • Build!

How to use with Swift

Steerpath framework classes can be included by adding the following to your source code:

import Steerpath

How to use with Objective-C

Steerpath framework classes can be included by adding the following to your source code:

@import Steerpath;

How to update PodSpec (for Steerpath Developers)

  1. If this is the first time you are updating the PodSpec you need to do the following:
  1. Replace the Steerpath.podspec.json file with your updated file.
  2. Run the following command in Terminal:
./publish.sh
  1. You will be prompted with a list of local CocoaPod repositories similar to the one below. Select (type/copy paste) the repository you're updating and hit enter.
Attempting to list local cocoapod repositories:

bitbucket-nimbledevices-steerpath-sdk-ios-podspec
master
bitbucket-nimbledevices-steerpath-smart-sdk-podspec
steerpath-map-sdk-bitbucket


Select repository for publish:
  1. You will need to confirm the repository with the next prompt.
Are you sure you want to publish to bitbucket-nimbledevices-steerpath-sdk-ios-podspec? (y/n):
  1. Publishing/uploading will run. After completion pull and push the changes into git.

  2. Great success!

Feedback, Support & Suggestions

  • Contact: support@steerpath.com