2012-02-05 23:40:20 +00:00
|
|
|
//
|
|
|
|
// TestFlight.h
|
|
|
|
// libTestFlight
|
|
|
|
//
|
|
|
|
// Created by Jonathan Janzen on 06/11/11.
|
|
|
|
// Copyright 2011 TestFlight. All rights reserved.
|
|
|
|
|
|
|
|
#import <Foundation/Foundation.h>
|
2012-02-26 22:01:17 +00:00
|
|
|
#define TESTFLIGHT_SDK_VERSION @"0.8.3"
|
2012-02-05 23:40:20 +00:00
|
|
|
#undef TFLog
|
|
|
|
|
|
|
|
#if __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
void TFLog(NSString *format, ...);
|
|
|
|
#if __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TestFlight object
|
|
|
|
* All methods are class level
|
|
|
|
*/
|
|
|
|
@interface TestFlight : NSObject {
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add custom environment information
|
|
|
|
* If you want to track custom information such as a user name from your application you can add it here
|
|
|
|
*
|
|
|
|
* @param information A string containing the environment you are storing
|
|
|
|
* @param key The key to store the information with
|
|
|
|
*/
|
|
|
|
+ (void)addCustomEnvironmentInformation:(NSString *)information forKey:(NSString*)key;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Starts a TestFlight session
|
|
|
|
*
|
|
|
|
* @param teamToken Will be your team token obtained from https://testflightapp.com/dashboard/team/edit/
|
|
|
|
*/
|
|
|
|
+ (void)takeOff:(NSString *)teamToken;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets custom options
|
|
|
|
*
|
|
|
|
* @param options NSDictionary containing the options you want to set available options are described below
|
|
|
|
*
|
|
|
|
* Option Accepted Values Description
|
|
|
|
* reinstallCrashHandlers [ NSNumber numberWithBool:YES ] Reinstalls crash handlers, to be used if a third party
|
|
|
|
* library installs crash handlers overtop of the TestFlight Crash Handlers
|
|
|
|
* logToConsole [ NSNumber numberWithBool:YES ] YES - default, sends log statements to Apple System Log and TestFlight log
|
|
|
|
* NO - sends log statements to TestFlight log only
|
2012-02-26 22:01:17 +00:00
|
|
|
* logToSTDERR [ NSNumber numberWithBool:YES ] YES - default, sends log statements to STDERR when debugger is attached
|
|
|
|
* NO - sends log statements to TestFlight log only
|
|
|
|
* sendLogOnlyOnCrash [ NSNumber numberWithBool:YES ] NO - default, sends logs to TestFlight at the end of every session
|
2012-02-05 23:40:20 +00:00
|
|
|
* YES - sends logs statements to TestFlight only if there was a crash
|
|
|
|
*/
|
|
|
|
+ (void)setOptions:(NSDictionary*)options;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Track when a user has passed a checkpoint after the flight has taken off. Eg. passed level 1, posted high score
|
|
|
|
*
|
|
|
|
* @param checkpointName The name of the checkpoint, this should be a static string
|
|
|
|
*/
|
|
|
|
+ (void)passCheckpoint:(NSString *)checkpointName;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Opens a feedback window that is not attached to a checkpoint
|
|
|
|
*/
|
|
|
|
+ (void)openFeedbackView;
|
|
|
|
|
2012-02-26 22:01:17 +00:00
|
|
|
/**
|
|
|
|
* 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 feedback Your users feedback, method does nothing if feedback is nil
|
|
|
|
*/
|
|
|
|
+ (void)submitFeedback:(NSString*)feedback;
|
|
|
|
|
2012-02-05 23:40:20 +00:00
|
|
|
@end
|