AltList 开源项目教程

1. 项目介绍

AltList 是一个现代化的 AppList 替代品，它的主要目的是提供一个易于使用且易于定制的框架，用于处理应用程序的偏好设置。与 AppList 的 ALApplicationList 类不同，AltList 没有获取已安装应用程序的方法，因为像 LSApplicationWorkspace 和 LSApplicationProxy（MobileCoreService / CoreServices 框架）这样的 iOS 类已经能够完成这项工作。因此，AltList 不需要与 SpringBoard 进行通信。

AltList 的特点包括：

• 使用 LSApplicationWorkspace，不依赖于 RocketBootstrap 或 SpringBoard 注入。
• 支持搜索栏。
• 支持应用程序部分（类似于 AppList）。
• 如果只有一个部分指定，则支持字母索引。
• 不重复造轮子，支持 iOS 7 及以上版本。

2. 项目快速启动

首先，你需要运行 install_to_theos.sh 脚本，并将 AltList 添加到你的项目 makefile 中：

<YOUR_PROJECT>_EXTRA_FRAMEWORKS = AltList

然后，你可以在你的代码中导入 AltList：

#import <AltList/AltList.h>

或者，你可以在你的偏好设置 plist 文件中直接使用下面的类。

3. 应用案例和最佳实践

简单的 plist-only 方法

对于非常简单的偏好设置，你可以直接从 entry.plist 使用 AltList 而不需要实现任何类。例如，查看 AltListTestBundlelessPreferences。

应用程序部分的指定

AltList 允许你指定应该显示的应用程序部分。它带有一些预设的部分类型，如所有应用程序、系统应用程序、用户安装的应用程序等。你也可以创建自定义部分，并指定自己的部分名称和谓词。

 AltListSection *section = [[AltListSection alloc] init];
 section.sectionType = @"Custom";
 section.sectionName = @"My Custom Section";
 section.sectionPredicate = @"(bundleIdentifier LIKE 'com.example.*')"];

搜索栏的使用

如果你想在列表顶部添加一个搜索栏，可以设置 useSearchBar 为 YES：

self.useSearchBar = YES;

4. 典型生态项目

目前，AltList 社区内并没有明确列出典型的生态项目。但是，任何需要处理应用程序偏好设置的开发者都可以考虑使用 AltList 作为其项目的依赖。AltList 的灵活性使其成为创建自定义设置界面和应用程序管理的理想选择。