Soundflower 技术文档

本文档将详细介绍如何安装、使用以及配置 Soundflower 项目，并包含项目 API 的使用说明。

1. 安装指南

环境要求

• 操作系统：macOS
• 开发工具：Xcode 3.1（可以从 Apple Developer 下载）

安装步骤

1. 打开终端窗口，并切换至 Soundflower 文件夹。

2. 进入 Tools 目录：

   cd Tools
   

3. 构建 Soundflower：

   ./build.rb
   

   build.rb 脚本将提供所需参数的信息（开发或部署），您需要提供这些参数（可以是 dev 或 dep 的简写形式）。脚本还会提示您输入密码，以便正确设置权限并在构建完成后自动加载 kext。

4. 如果需要，构建 Soundflower 的安装程序：

   ./installer.rb
   

2. 项目使用说明

权限配置

在 kext 扩展包中，文件权限需要按以下方式设置：

• 所有者：root - 读写
• 组：wheel - 只读
• 其他用户：只读

Xcode 无法以 sudo 权限执行脚本，也无法调用用户交互（如 applescript 对话框）来完成构建。在 Soundflower 的 'Tools' 文件夹中有一个名为 'load.rb' 的 Ruby 脚本，该脚本将使用 sudo 将构建的 kext 复制到安装位置，并正确设置所有者和组权限。当您运行 'build.rb' 脚本时，它将构建项目并自动运行 'load.rb' 脚本。

版本号更新

主版本号在 Xcode 项目的目标设置中更新。具体来说，您需要编辑 MODULE_VERSION 条目来设置它。在其他需要版本号的地方（包括安装程序中），它都会从这个主位置获取。

3. 项目 API 使用文档

目前项目中没有明确提供的 API 文档。用户需要根据项目的源代码和实现逻辑来理解和使用可能存在的 API。

4. 项目安装方式

Soundflower 的安装方式包括：

• 通过构建脚本自动安装：运行 ./build.rb 脚本后，会自动加载 kext。
• 通过安装程序安装：运行 ./installer.rb 脚本，会创建一个安装程序，用户可以通过该程序安装 Soundflower。

请确保按照上述指南进行操作，以顺利安装和使用 Soundflower。