Upgrading to MOCA SDK 1.3 - mocaplatform/moca-ios-sdk GitHub Wiki

MOCA SDK for iOS

The MOCA SDK v1.3 is now available.

What's new in MOCA SDK 1.3?

The MOCA SDK v1.3 provides built-in support for iOS 8. With this new feature, you can add MOCA Platform services to your iOS 6, 7 and 8 apps for iPhone/iPad devices.

Version 1.3 of the MOCA SDK for iOS contains the following changes since the last release:

  • Improved geo-location tracking with low battery usage
  • Geofence entry/exit experiences with support for more 20 geofences (beyond iOS limit)
  • Beacon/Zone/Place analytics
  • Automatic geo analytics
  • Passbook actions support

Upgrading SDK to V1.3

  1. To upgrade your app integrated with previous version of MOCA SDK, first download latest stable version of MOCA SDK archive v1.3.
  2. Xcode 6 with the iOS development kit is recommended to build an iOS app using MOCA SDK v1.3.
  3. The SDK requires iOS 6.0, 6.1, 7.0, 7.1, or 8.0.
  4. Unzip the archive.

Once downloaded the SDK, you’ll need to add it to your project.

  1. Open your app project in Xcode.
  2. Remove existing SDK from your app project.
  3. Navigate to where you downloaded the SDK and drag the mocasdk.framework folder into your project in Xcode.
  4. Make sure Copy items into destination group's folder is selected.
  5. Press the Finish button.
  6. Ensure that you have added to your project the following dependent frameworks:
    • AudioToolbox.framework
    • CoreTelephony.framework
    • MobileCoreServices.framework
    • SystemConfiguration.framework
    • CoreLocation.framework
    • libsqlite3.0.dynlib
    • CoreBluetooth.framework (since 1.3)
    • PassKit.framework (since 1.3)

To do this, select your project file in the file explorer, select your target, and select the Build Phases sub-tab. Under Link Binary with Libraries, press the + button, to select and add all required frameworks.

In XCode 6, ensure you add mocasdk.framework into Embedded Binaries section General tab of your app target.

  1. Finally, if your app targets iOS 8, you must add NSLocationAlwaysUsageDescription or NSLocationWhenInUseUsageDescription key to your project’s Info.plist containing the message to be displayed to the user at the prompt.

For example:

<key>NSLocationAlwaysUsageDescription</key>
<string>This app will use your location information to identify nearby places and to notify you about available proximity experiences.</string>

Support

If you want to help with the MOCA iOS SDK, contact [email protected].

Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️