created by Shazron Abdullah
Apache 2.0 License except for the TestFlight SDK
Project includes;
-
iOS 2.02 SDK
-
Android 1.20 SDK
To add this plugin just type:
cordova plugin add https://github.com/shazron/TestFlightPlugin.git
To remove this plugin type:
cordova plugin remove com.testflightapp.cordova-plugin
The plugin's JavaScript functions are called after creating the plugin object thus:
var tf = new TestFlight();
tf.takeOff(win, fail, "some_team_token");
Make sure you create the object after the "deviceready" event has fired.
See the functions below (and the TestFlight SDK docs) for usage. Unfortunately all of TestFlight's SDK functions return void, and errors can only be gleaned from the run console, so check that for errors.
// Get a reference to the plugin first
var tf = new TestFlight();
/*
Add custom environment information
If you want to track a user name from your application you can add it here
@param successCallback function
@param failureCallback function
@param key string
@param information string
*/
tf.addCustomEnvironmentInformation(successCallback, failureCallback, 'key', 'information');
/*
Starts a TestFlight session
@param successCallback function
@param failureCallback function
@param teamToken string
*/
tf.takeOff(successCallback, failureCallback, 'teamToken');
/*
Sets custom options
@param successCallback function
@param failureCallback function
@param options object i.e { reinstallCrashHandlers : true }
*/
tf.setOptions(successCallback, failureCallback, options);
/*
Track when a user has passed a checkpoint after the flight has taken off. Eg. passed level 1, posted high score
@param successCallback function
@param failureCallback function
@param checkpointName string
*/
tf.passCheckpoint(successCallback, failureCallback, 'checkpointName');
/*
Send log message to testflight servers...
@param successCallback function
@param failureCallback function
@param message string
*/
tf.remoteLog(successCallback, failureCallback, 'message');
/*
Send log message to testflight servers... (async).
Note that you might lose logs in a crash.
@param successCallback function
@param failureCallback function
@param message string
*/
tf.remoteLogAsync(successCallback, failureCallback, 'message');
/*
Submits custom feedback to the site. Sends the data in feedback to the site.
This is to be used as the method to submit feedback from custom feedback forms.
@param successCallback function
@param failureCallback function
@param feedback Your users feedback, method does nothing if feedback is nil
*/
tf.submitFeedback(successCallback, failureCallback, 'feedback');
/*
Sets your own Device Identifier.
If you do not provide the identifier you will still see all session data, with
checkpoints and logs, but the data will be anonymized.
@param successCallback function
@param failureCallback function
@param deviceIdentifer The current devices device identifier
*/
tf.setDeviceIdentifier(successCallback, failureCallback, 'deviceIdentifier');
/*
Manually start a session.
@param successCallback function
@param failureCallback function
*/
tf.manuallyStartSession(successCallback, failureCallback);
/*
Manually end a session.
@param successCallback function
@param failureCallback function
*/
tf.manuallyEndSession(successCallback, failureCallback);