Installation

To install the Aspera SDK for iOS or OSX:

  1. Drag the appropriate AsperaSDK.framework object into your Xcode project. When prompted, check Copy items if needed to have the AsperaSDK framework copied into the root of your project.

    • Note: if you wish to have the AsperaSDK framework reside at a location other than the root of your project you should leave Copy items if needed unchecked and instead verify that the path to AsperaSDK.framework appears in your project’s Framework Search Paths setting
  2. for OSX projects (and only for OSX) select the General tab and add AsperaSDK.framework to Embedded Binaries.

The SDK’s main header is AsperASDK/AsperaSDK.h which should be included in your project. For Objective-C projects this may be done by importing the header directly in your source files:

#import "AsperaSDK/AsperaSDK.h"

For Swift projects the header must be imported in the bridging header along with the Foundation framework:

#import <Foundation/Foundation.h>
#import "AsperaSDK/AsperaSDK.h"

If your Swift project doesn’t have a bridging header you will need to add one.

Common Errors

iOS: If your project fails compilation with the error AsperaSDK/AsperaSDK.h' file not found it is likely that the project cannot find the AsperaSDK framework. Please check the project’s Framework Search Paths setting and verify that the location of AsperaSDK.framework is contained therein.

OSX: If your project crashes with the exception dyld: Library not loaded... Reason: image not found the AsperaSDK.framework may be missing from the Embedded Binaries section in the General tab of your project.