SpringBoardPlugins

From iPhone Development Wiki
Revision as of 23:40, 10 November 2013 by Britta (talk | contribs) (adding link to theiphonewiki article)
Jump to: navigation, search

SpringBoardPlugins contains plugins for SpringBoard. The exact location for this directory is determined by the method -[SpringBoard springBoardPluginsDirectory].

SpringBoardPlugins serve two purposes:

  1. Supporting “ZoomTouch”, the accessibility feature that magnifies the screen by two to five times.[1]
  2. Supporting lock screen bundles, such as the Nike and iPod lockscreens. This is the basis of Cydget. See /System/Library/SpringBoardPlugins on TheiPhoneWiki for a list.

Lock screen bundles have been supported starting in 2.1, and ZoomTouch starting in 3.0.

Structure of ZoomTouch bundle

The ZoomTouch bundle must be named ZoomTouch.bundle. The principal class should implement the +disableZoom and +enableZoom methods.

Enabling ZoomTouch

ZoomTouch is the only non-lockscreen plugin. As such, it is hard-coded into SpringBoard.

...
// Inside SpringBoard
[(SpringBoard *)[UIApplication sharedApplication] setZoomTouchEnabled:YES];
...

Structure of lock screen bundles

A lock screen bundle must have an extension of .bundle. The principle class should implement the +rootViewController method, and returns an SBAwayViewPluginController.

Enabling lock screen bundles

Lock screen bundles can be toggled using SpringBoardServices's SBEnableLockScreenBundle() function outside of SpringBoard, and SBAwayController's -enableLockScreenBundleWithName: and -disableLockScreenBundleWithName: within SpringBoard. When called outside of SpringBoard, the binary must have the com.apple.springboard.activateawayviewplugins entitlement.

References

  1. Apple - Accessibility - iPhone - Vision http://www.apple.com/accessibility/iphone/vision.html