Appaloosa SDK

Overview

Appaloosa SDK library is a simple library that helps you to:

Auto-update your application stored on Appaloosa Store server
Receive feedback from your users directly from the app (iPhone and iPad)
Launch a dev-panel giving information about the device and the application
Manage authorizations for your application
Prevent your application to run on a jailbroken device

Requirements

Appaloosa SDK library uses ARC and is compatible with iOS 5+.

/!\ In order to complete the setup for the features "Auto-update" and "Blacklist", the device must make at least one successful login on the native store to register its ADID to the server. /!\ Your App ID must be explicit (as opposed to wildcard) /!\ Testing on the simulator won't work

Integrate Appaloosa SDK with CocoaPods

Simply add the following line to your Podfile :

pod 'OTAppaloosa'

Refer to CocoaPods for more information about it.

Integrate Appaloosa SDK the old fashioned way

Download and import OTAppaloosa sources and its dependencies :
- TPKeyboardAvoiding.
- UIDeviceAddition.
- Reachability.
- Base64.
- SFHFKeychainUtils.
Add OTAppaloosa sources to your project.

Configure Appaloosa Agent

Once the Appaloosa SDK is integrated to your project, you need to configure the agent with the storeId and the storeToken.

Register the Appaloosa Agent with your storeId and storeToken (you can find the storeId and storeToken on this page : http://www.appaloosa-store.com/settings).

[[OTAppaloosaAgent sharedAgent] registerWithStoreId:APPALOOSA_STORE_ID
                                         storeToken:APPALOOSA_STORE_TOKEN
                                        andDelegate:self];

Check for application update - simple version

In your AppDelegate.m file, launch the autoupdate when your application starts :
1. Import the plugin: #import "OTAppaloosa.h"
2. Register the Appaloosa Agent with StoreId and StoreToken
3. In method - (void)applicationDidBecomeActive:(UIApplication *)application, add the following code line:

[[OTAppaloosaAgent sharedAgent] checkUpdates];

Check for application update - clever version

Into your AppDelegate.h file
1. Import the plugin: #import "OTAppaloosa.h"
2. Add the OTAppaloosaAgentDelegate into your interface:

@interface AppDelegate : UIResponder <UIApplicationDelegate, OTAppaloosaAgentDelegate>

Into your AppDelegate.m file, launch the autoupdate when your application starts :
1. Register the Appaloosa Agent (storeId + storeToken)
2. In method - (void)applicationDidBecomeActive:(UIApplication *)application, add the following code line:

[[OTAppaloosaAgent sharedAgent] checkUpdates];

Implement delegate methods if you want your own behaviour :
1. The method - (void)applicationUpdateRequestSuccessWithApplicationUpdateStatus:(OTAppaloosaUpdateStatus)appUpdateStatusto inform the application needs to be updated. You need to analyze the 'appUpdateStatus' to know if an update is available and download the new version. By default, - if the application is up to date, nothing occures. - if an update is available, an alert view asks the user to download it. If you want to launch the download : [[OTAppaloosaAgent sharedAgent] downloadNewVersion];
2. The method `- (void)applicationUpdateRequestFailureWithError:(NSError *)error to be inform if something wrong occured during the update request.

Add in-app-feedback to your app

This SDK provides a fully integrated solution to send feedback to your dev team. In your appDelegate file, add the following line:

[[OTAppaloosaAgent sharedAgent] feedbackControllerWithDefaultButtonAtPosition:kAppaloosaButtonPositionRightBottom forRecipientsEmailArray:@[@"e.mail@address.com"]];

You have 2 possible positions for the default feedback button :

kAppaloosaButtonPositionRightBottom
kAppaloosaButtonPositionBottomRight

If you prefer to use your own button/action to trigger feedback, you can use the following line:

[[OTAppaloosaAgent sharedAgent] openFeedbackControllerWithRecipientsEmailArray:@[@"e.mail@address.com"]];

To see how to use this feature, take a look at the Example/OTAppaloosaDemo/ project.

Add the dev panel to your app

This SDK also provides a dev panel which gives information about the device and the application. In your appDelegate file, add the following line:

[[OTAppaloosaAgent sharedAgent] devPanelWithDefaultButtonAtPosition:kAppaloosaButtonPositionRightBottom];

You have 2 possible positions for the default dev-panel button :

kAppaloosaButtonPositionRightBottom
kAppaloosaButtonPositionBottomRight

If you prefer to use your own button/action to trigger the dev panel, you can use the following line:

[[OTAppaloosaAgent sharedAgent] openDevPanelController];

To see how to use this feature, take a look at the Example/OTAppaloosaDemo/ project.

Check authorizations for application

This SDK provides a kill switch mecanism. From the web interface (http://www.appaloosa-store.com/), you are able to authorize or not a device to access the application. The mecanism works offline by reading the blacklisted status from the keychain.

In your appDelegate file, add the following line to check authorizations when the application becomes active - (void)applicationDidBecomeActive:(UIApplication *)application:

[[OTAppaloosaAgent sharedAgent] checkAuthorizations];

By default :

if the user is authorized, nothing occurs.
if the user is not authorized, an alert view is displayed with the appropriated message and the application is killed.

If you prefer to develop your own behaviour, you should implement the OTAppaloosaAgentDelegate :

to know if the user is authorized : - (void)applicationAuthorizationsAllowed;
to know if the user is not authorized : - (void)applicationAuthorizationsNotAllowedWithStatus:(OTAppaloosaAutorizationsStatus)status andMessage:(NSString *)message

Check if the device is jailbroken

You can prevent your app from running on a jailbroken device.