Difference between revisions of "IconSupport"

From iPhone Development Wiki
Jump to: navigation, search
m (Remove extra empty line)
(New How to use this library format.)
Line 18: Line 18:
 
<blockquote>
 
<blockquote>
 
<p>Uses a unique ID for each combination of packages, so icon state is never lost via respring or uninstalling a new package.</p>
 
<p>Uses a unique ID for each combination of packages, so icon state is never lost via respring or uninstalling a new package.</p>
 +
</blockquote>
 +
 +
== How to use this library ==
 +
 +
Headers are available from [https://github.com/Xuzz/IconSupport/blob/master/Extension/ISIconSupport.h IconSupport's GitHub project]. If using Theos, place the headers in <code>$THEOS/include/IconSupport</code>.
 +
 +
=== Include directive ===
 +
 +
<source lang="objc">
 +
#import <IconSupport/ISIconSupport.h>
 +
</source>
 +
 +
=== Packaging ===
 +
 +
Add to your package's control file:
 +
 +
* <code>, com.chpwn.iconsupport</code> to the <code>Depends</code> field.
 +
 +
== Usage ==
 +
 +
<source lang="logos">
 +
%ctor {
 +
dlopen("/Library/MobileSubstrate/DynamicLibraries/IconSupport.dylib", RTLD_NOW);
 +
[[%c("ISIconSupport") sharedInstance] addExtension:@"theNameOfMyExtension"];
 +
}
 +
</source>
  
<p>Example usage (in the initializer function of your extension):</p>
+
== External links ==
  dlopen("/Library/MobileSubstrate/DynamicLibraries/IconSupport.dylib", RTLD_NOW);
+
 
  [[objc_getClass("ISIconSupport") sharedInstance] addExtension:@"theNameOfMyExtension"];
+
* [https://github.com/Xuzz/IconSupport source on GitHub].
</blockquote>
+
 
 +
{{Navbox Library}}
 +
 
 +
[[Category:Cydia packages]]
  
[[Category:Cydia_packages]]
+
[[Category:Directories in /Library]]

Revision as of 23:36, 6 August 2016

IconSupport
Cydia Package
Developer Sakurina, chpwn, ashikase
Package ID com.chpwn.iconsupport
Latest Version 1.8.1-1

IconSupport is a library that helps icon-layout-modifying tweaks play nicely together.

Quoted from its depiction:

IconSupport is a package for use by extensions that modify how SpringBoard lays-out icons (such as extensions that change the number of icons shown per row/column).

Normally, syncing with iTunes or booting into Mobile Substrate's Safe Mode would cause these modified layouts to be reset; IconSupport prevents this.

IconSupport also handles repairing layouts when installing and uninstalling IconSupport-enabled extensions.

Quoted from the README of its source on GitHub:

Uses a unique ID for each combination of packages, so icon state is never lost via respring or uninstalling a new package.

How to use this library

Headers are available from IconSupport's GitHub project. If using Theos, place the headers in $THEOS/include/IconSupport.

Include directive

#import <IconSupport/ISIconSupport.h>

Packaging

Add to your package's control file:

  • , com.chpwn.iconsupport to the Depends field.

Usage

 %ctor {
	dlopen("/Library/MobileSubstrate/DynamicLibraries/IconSupport.dylib", RTLD_NOW);
	 [[%c("ISIconSupport") sharedInstance] addExtension:@"theNameOfMyExtension"];
}

External links