OS-X-USB-Inject-All 开源项目使用教程

本教程旨在引导您了解并使用 OS-X-USB-Inject-All 这一开源项目，该项目主要用于自动注入苹果Intel平台上的所有USB端口，适用于10.11及更高版本的macOS系统。以下是该开源项目的三个核心内容模块解析。

1. 项目目录结构及介绍

OS-X-USB-Inject-All 的目录结构有序地组织了代码和资源配置：

OS-X-USB-Inject-All/
│
├── USBInjectAll.xcodeproj     # Xcode项目文件，用于编译内核扩展(KEXT)
├── USBInjectAll.kext          # 主要的内核扩展包，包含自动注入USB端口的逻辑
│   ├── Contents                # 内容目录，含Info.plist等关键文件
│   │   ├── Info.plist           # 配置文件，定义KEXT的行为和依赖
│   └── ...                     # 其它支持文件和资源
├── SSDT-UIAC-ALL.dsl         # 示例SSDT脚本，用于自定义USB配置
├── SSDT-UIAC.dsl             # 另一个示例SSDT，可能用于特定配置调整
├── ...                        # 更多工具文件如配置补丁、字符串处理脚本等
└── README.md                  # 项目说明文档，包含重要使用信息和指导

• USBInjectAll.xcodeproj：这是项目的主入口点，对于开发者来说，可以通过这个项目文件在Xcode中打开并编译KEXT。
• USBInjectAll.kext：存放KEXT的核心代码和配置。其中Info.plist是关键，它定义了KEXT的属性和行为。
• DSL文件（如SSDT-UIAC-ALL.dsl）：提供了通过ACPI来定制USB配置的方法，帮助用户进行高级配置。

2. 项目的启动文件介绍

项目本身不涉及“启动文件”以传统意义上的应用程序启动。它的“启动”更多是指当macOS加载时内核扩展(KEXT)的激活过程。关键在于USBInjectAll.kext被正确放置，并且系统启动时由macOS加载。因此，虽然没有单独的可执行文件作为启动项，但确保KEXT位于系统能够识别并加载的位置（如 /Library/Extensions 或 Clover/EFi的kexts目录），就是其“启动”的准备步骤。

3. 项目的配置文件介绍

Info.plist

位于USBInjectAll.kext/Contents/中的Info.plist是最主要的配置文件。它包含了KEXT的重要元数据，比如识别符、版本号、权限需求以及KEXT需要注入系统的USB配置信息。此文件控制了哪些USB控制器被识别以及它们应该如何工作。开发者和高级用户可以在这里微调KEXT的行为，尽管通常推荐通过创建自定义SSDT或使用提供的命令行参数来实现更细致的配置调整。

自定义配置：SSDT 和 config_patches.plist

• SSDT-UIAC-ALL.dsl 和 SSDT-UIAC.dsl: 提供了模板，允许用户通过ACPI表来自定义USB端口的行为和映射，这对于解决特定硬件兼容性和优化是非常重要的。

• config_patches.plist: 包含了补丁，特别是针对macOS限制的修复，例如15个端口的限制，这使得用户可以根据自己的硬件情况修改配置，以适应更多USB端口。

总结，OS-X-USB-Inject-All项目通过精心设计的目录结构和配置文件，提供了一种灵活的方式去处理复杂的USB端口注入问题，尤其适合那些寻求个性化USB配置的macOS用户和开发者。正确理解和使用这些文件，将帮助您充分利用此工具。