AltList 开源项目使用教程

1. 项目的目录结构及介绍

AltList 项目是一个用于替代 AppList 的现代框架，它可以帮助开发者处理应用程序的偏好设置。以下是项目的目录结构及各部分的简要介绍：

• AltList.x: 项目的主要文件，包含了 AltList 框架的核心代码。
• AltList.h: AltList 框架的公共头文件，用于导入框架。
• LSApplicationProxy+AltList.h 和 LSApplicationProxy+AltList.m: 为 LSApplicationProxy 类添加 AltList 扩展的文件。
• PSSpecifier+AltList.h 和 PSSpecifier+AltList.m: 为 PSSpecifier 类添加 AltList 扩展的文件。
• ATLApplicationListControllerBase.*: ATLApplicationListControllerBase 类及其头文件，是其他类的基类。
• ATLApplicationSection.*: ATLApplicationSection 类及其头文件，用于定义应用程序的各个部分。
• ATLApplicationListSelectionController.*: 用于选择应用程序列表的控制类及其头文件。
• AltListTestBundlelessPreferences: 一个示例，展示了如何在没有实现任何类的情况下直接从 entry.plist 使用 AltList。
• Makefile: 用于构建项目的 Makefile 文件。
• install_to_theos.sh: 安装脚本，用于将 AltList 集成到你的项目中。
• README.md: 项目说明文件，包含了项目的介绍和使用说明。

2. 项目的启动文件介绍

项目的启动主要是通过 install_to_theos.sh 脚本实现的。这个脚本会将 AltList 集成到你的项目中。运行以下命令来启动集成过程：

chmod +x install_to_theos.sh
./install_to_theos.sh

在执行脚本之后，你需要将 AltList 添加到你的项目的 makefile 文件中，如下所示：

<YOUR_PROJECT>_EXTRA_FRAMEWORKS = AltList

之后，你可以在你的代码中导入 AltList 框架：

#import <AltList/AltList.h>

或者在你的偏好设置 plist 文件中直接使用 AltList 提供的类。

3. 项目的配置文件介绍

AltList 的配置主要通过 plist 文件进行。以下是几个关键的配置选项：

• sections: 一个数组，定义了应用程序列表中显示的部分。每个部分是一个字典，包含以下键：

  • sectionType: 部分类型，如 "All", "System", "User", "Hidden", "Visible" 或 "Custom"。
  • sectionName: 对于自定义部分，这是部分的名称。
  • sectionPredicate: 对于自定义部分，这是用于过滤应用程序的谓词。
  • customClass: 如果需要实现更多自定义行为，这是自定义的 ATLApplicationSection 子类的名称。

• useSearchBar: 一个布尔值，指示是否在顶部显示一个搜索栏以搜索应用程序。

• hideSearchBarWhileScrolling: 当 useSearchBar 启用时，指示在滚动时是否隐藏搜索栏。

• includeIdentifiersInSearch: 当 useSearchBar 启用时，指示是否可以通过应用程序的标识符搜索。

这些配置选项可以在你的 plist 文件中设置，以适应你的具体需求。通过合理配置这些选项，你可以创建一个功能丰富且易于使用的应用程序列表界面。