UIApplication

UIApplication is a singleton object that represents the application.

UIApp

Signature	extern UIApplication* UIApp;
Available in	2.0 –

The method +[UIApplication sharedInstance] is equivalent to using external symbol UIApp. The latter is often used in debugging environments such as Cycript for convenience.

Event recording

Main article: UIApplication/Event recording

UIApplication provides the -_addRecorder: and related methods to record user's events (as GSEvents). Event playback is also supported, so it can be used as a macro system.

Suspension settings

Signature	-(BOOL)applicationSuspend:(GSEventRef)event settings:(NSMutableDictionary*)settings;
Available in	2.0 –

This method will be called before the app gets suspended. By default UIApplication doesn't contain this method. You have to implement this if needed. You can change the settings here, to generate the initial state of next resumption. This technique is used in many built-in apps. The recognized keys are:

Key	Value type	Usage
UISuspendedStatusBarModeKey	Integer	The initial status bar mode.
UISuspendedStatusBarOrientationKey	Integer	The initial status bar orientation.
kUISuspendedReturnToLastAppKey	Boolean	?
UISuspendedRoleID	String	? (kUISuspendedReturnToLastAppKey must be true for this to have any effects)
UISuspendedDefaultPNGKey	String	The file name of the default PNG image to use. For example, if you want to use Default-Landscape.png when the app starts, set this key to @"Default-Landscape".

These values are written sent to SpringBoard with the GSSendApplicationSuspendedEvent function.

If this method returns NO, the app will just be backgrounded.

References

• Official reference: http://developer.apple.com/IPhone/library/documentation/UIKit/Reference/UIApplication_Class/Reference/Reference.html
• Extra header: http://github.com/kennytm/iphone-private-frameworks/blob/master/UIKit/UIApplication2.h