Framework for access to lists of installed apps and cool app selection preference panes!
The preferences, unlike all other iOS preference panes makes use of a UICollectionView with a fresh but iOS like look rather then the standard UITableView. It comes with drag and drop, quick edit, and search capabillities to improve user experience within your tweaks.
Requires a unique ID for saving the list in preferences, which can be retrieved in a number of ways. The recommended method is NSUserDefaults. Can also use Post Notification, to allow you to instantly retrieve the new listed of selected apps whenever a change to the selected apps is made.
| Downloads: | Latest Release | Headers | Example Use | Package | Framework |
First, You have to install the latest deb.
when the installation process is complete, you have to add the latest KBAppList framework to /theos/lib/.
Now we can move onto the tweak's folder. First you would need to add
KBAppList as a dependancy, this can be done by add it to the control file like Depends: mobilesubstrate, com.kaneb.kbapplist. Next You would need to add TWEAKSNAME_EXTRA_FRAMEWORKS += KBAppList in the makefile in the Preferences folder.
It is really easy to add a tab to view the applist inside your preferences, all you need to do is add this inside your root.plist
<dict>
<key>key</key>
<string>UNIQUEID</string> <!-- your unique prefs key, for retrieving selected apps in your tweak -->
<key>defaults</key>
<string>com.example.tweak</string> <!-- The pref's bundleID -->
<key>default</key>
<string></string> <!-- This will default to all apps being unselected -->
<key>appList</key>
<string>allApps</string> <!-- Choose which apps should be displayed for selection -->
<key>label</key>
<string>DISPLAYNAME</string> <!-- What the tab will be called in the settings app -->
<key>postNotification</key> <!-- This is if you want to use system notifications for real time preference changes -->
<string>com.example.tweak-prefsreload</string>
<key>cell</key>
<string>PSLinkCell</string>
<key>detail</key>
<string>ALViewController</string>
<key>icon</key>
<string>iconpath.png</string>
<key>isController</key>
<true/>
</dict>
Finally retrieving the values from the Tweak.xm file can be easily done like such.
NSUserDefaults *preferences = [[NSUserDefaults alloc] initWithSuiteName:@"com.example.tweak"];
NSArray *apps = [preferences objectForKey:@"UNIQUEID"];
NSArray *appsName = [apps valueForKey:@"name"];
NSArray *appsID = [apps valueForKey:@"bundleID"];
If you are going to use postNotifcation you can use this outside the %hook.
static void loadPrefs() {
NSUserDefaults *preferences = [[NSUserDefaults alloc] initWithSuiteName:@"com.example.tweak"];
NSArray *apps = [preferences objectForKey:@"UNIQUEID"];
NSArray *appsName = [apps valueForKey:@"name"];
NSArray *appsID = [apps valueForKey:@"bundleID"];
}
%ctor {
CFNotificationCenterAddObserver(
CFNotificationCenterGetDarwinNotifyCenter(), NULL,
(CFNotificationCallback)loadPrefs,
CFSTR("com.example.tweak-prefsreload"), NULL,
CFNotificationSuspensionBehaviorDeliverImmediately);
loadPrefs();
}
| Keys | Option 1 | Option 2 | Option 3 | Option 4 |
|---|---|---|---|---|
| key | UNIQUE STRING | |||
| defaults | UNIQUE bundleID | |||
| default | "selected" | "unselected" or nil | ||
| postNotification | UNIQUE BUNDLEID | nil | ||
| appList | "userApps" | "systemApps" | "allApps" | "audioApps" |
| label | STRING | nil | ||
| selectionAllowance | INTEGER | nil |
Please dont steel code!
This software is licensed under the BSD 4 License, detailed in the file LICENSE.md If you do wish to use this code in your project then in addition to the License agreement you must also provide a link to my twitter @IndieDevKB. If for any reason you do not wish to include my twitter in your project, then please contact me so we can discuss another agreement.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent