Cabbage 项目使用与配置指南

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

Cabbage 是一个使用 Csound 编程语言开发音频插件和独立乐器的框架。项目目录结构如下：

• build/：构建目录，包含构建过程中生成的文件。
• CLIConverter/：命令行转换器相关文件。
• Csound/：Csound 相关文件和二进制。
• Docs/：项目文档。
• Examples/：示例项目和代码。
• Installers/：安装脚本和安装程序。
• JUCE/：JUCE 库相关文件。
• patches/：补丁和修改文件。
• Resources/：资源文件，如图标、图片等。
• Source/：源代码，包括 Cabbage IDE 和插件接口。
• Themes/：主题文件，用于定制界面外观。
• LICENSE：项目许可证文件。
• README.md：项目说明文件。
• commit.py、build.py 等脚本文件：项目构建和提交脚本。

2. 项目的启动文件介绍

Cabbage 项目的启动主要是通过 build.py 脚本。这个脚本负责检查所需的库和 SDK，并下载安装它们。以下是启动脚本的基本使用方法：

python build.py --config=Release

这将启动完整构建过程。如果你想生成 CMake 构建文件但不执行构建，可以使用以下命令：

python build.py --config=Debug --project=CabbagePluginSynth --build=False

对于 Linux 用户，如果需要安装额外依赖，可以设置 installLinuxDeps 参数为 True：

python build.py --config=Release --installLinuxDeps=True

3. 项目的配置文件介绍

项目的配置主要是通过 build.py 脚本中的参数进行。以下是一些主要的配置参数：

• --config CONFIG：指定构建配置（Debug 或 Release）。
• --project PROJECT：指定要构建的项目（Cabbage、CabbagePluginEffect、CabbagePluginSynth）。
• --packageType PACKAGETYPE：指定打包类型（Local、Remote、Minimal）。
• --build BUILD：设置是否执行构建过程。
• --manufacturer MANUFACTURER：指定制造商名称。
• --pluginDescription PLUGINDESCRIPTION：指定插件描述。
• --manufacturerCode MANUFACTURERCODE：指定制造商代码。
• --installLinuxDeps INSTALLLINUXDEPS：设置是否在 Linux 上安装依赖。
• --license LICENSE：指定许可证类型。

通过修改这些参数，你可以定制化构建过程以适应不同的需求和环境。