TestFlight Plugin for Apache Cordova

created by Shazron Abdullah

Apache 2.0 License except for the TestFlight SDK

Project includes;

• iOS 2.1.3 SDK

• Android 1.3 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);