ChuGins官方支持库使用与技术文档

1. 安装指南

1.1 预编译二进制文件

大多数ChuGins的预编译二进制文件已包含在ChuCK的macOS和Windows安装程序中。您可以在ChuCK官方网站下载最新版本。Linux用户（以及macOS和Windows的高级用户）可以从未源代码构建ChuGins。

1.2 从源代码构建

首先，克隆此仓库：

git clone --recurse-submodules https://github.com/ccrma/chugins.git
cd chugins

根据您的操作系统编译所有ChuGins：

• Linux: 运行 make linux
• macOS: 运行 make osx
• Windows: 使用Visual Studio解决方案 chugins.sln 编译

可选地，(在Linux和macOS上，需要管理员权限) 安装ChuGins：

sudo make install

2. 项目使用说明

ChuGins是ChuCK音频编程语言的插件。在运行时，ChuCK或miniAudicle会加载ChuGins，通过添加类库和音频单元生成器（UGens）和单元分析器（UAnae）来扩展语言的功能。本仓库包含了由ChuCK团队及其 respective authors 在所有支持平台上（macOS、Linux、Windows）维护的多个ChuGins。

ChuGins会自动加载，当命令行chuck或miniAudicle启动ChuCK虚拟机时。一旦加载，ChuGins的内容可以直接在语言中使用。

要正确加载ChuGin，请确保：

1. ChuGin版本与宿主版本兼容。
2. ChuGin位于默认搜索目录之一，或明确指定，例如使用命令行上的--chugin:<file>标志。

3. 项目API使用文档

有关已打包ChuGins的类库参考，请访问ChuCK官方文档。

4. 项目安装方式

请参考“安装指南”部分，了解如何从源代码或预编译二进制文件安装ChuGins。

ChuGins搜索路径

默认情况下，ChuGin加载器会递归搜索以下目录中的ChuGins（.chug）和ChuCK扩展（.ck）。可以通过命令行chuck的--chugin-path:<path>标志或在miniAudicle的“Preferences/ChuGins”选项卡中自定义这些搜索路径。

• macOS:

  /usr/local/lib/chuck
  /Library/Application Support/ChucK/chugins
  ~/Library/Application Support/ChucK/chugins
  ~/.chuck/lib
  

• Linux:

/usr/local/lib/chuck ~/.chuck/lib/

- Windows:

C:\Windows\system32\ChucK C:\Program Files\ChucK\chugins C:\Program Files (x86)\ChucK\chugins C:\Users%USERNAME%\Documents\ChucK\chugins