Gearmulator 项目下载及安装教程

1. 项目介绍

Gearmulator 是一个开源项目，旨在模拟基于 Motorola 56300 系列 DSP 的经典虚拟模拟合成器（VA synths）。这些合成器主要活跃于 90 年代末和 2000 年代初。Gearmulator 支持多种插件格式，包括 FST、VST3、AU、CLAP 和 LV2。它支持 64 位 x86（x64）和 ARM aarch64 架构，适用于 Windows 7+、macOS 10.13+ 和 Linux 平台。

2. 项目下载位置

要下载 Gearmulator 项目，请访问项目的 GitHub 仓库。你可以通过以下步骤进行下载：

1. 打开终端或命令提示符。
2. 使用 git clone 命令下载项目：

git clone https://github.com/dsp56300/gearmulator.git

3. 项目安装环境配置

3.1 Windows 环境配置

在 Windows 上安装 Gearmulator 需要以下环境配置：

• 操作系统：Windows 7 或更高版本。
• 编译器：Visual Studio 2019 或更高版本。
• CMake：版本 3.14 或更高版本。

配置步骤：

1. 安装 Visual Studio：

   • 下载并安装 Visual Studio 2019 或更高版本。
   • 确保安装了 C++ 开发工具。

2. 安装 CMake：

   • 下载并安装 CMake 3.14 或更高版本。
   • 将 CMake 添加到系统环境变量 PATH 中。

3.2 macOS 环境配置

在 macOS 上安装 Gearmulator 需要以下环境配置：

• 操作系统：macOS 10.13 或更高版本。
• 编译器：Xcode 10 或更高版本。
• CMake：版本 3.14 或更高版本。

配置步骤：

1. 安装 Xcode：

   • 从 App Store 下载并安装 Xcode。
   • 安装 Xcode 命令行工具：

     xcode-select --install
     

2. 安装 CMake：

   • 使用 Homebrew 安装 CMake：

     brew install cmake
     

3.3 Linux 环境配置

在 Linux 上安装 Gearmulator 需要以下环境配置：

• 操作系统：支持 C++17 的 Linux 发行版。
• 编译器：GCC 7 或更高版本。
• CMake：版本 3.14 或更高版本。

配置步骤：

1. 安装 GCC：

   • 使用包管理器安装 GCC 7 或更高版本。例如，在 Ubuntu 上：

     sudo apt-get install build-essential
     

2. 安装 CMake：

   • 使用包管理器安装 CMake 3.14 或更高版本。例如，在 Ubuntu 上：

     sudo apt-get install cmake
     

4. 项目安装方式

4.1 Windows 安装

1. 打开命令提示符：

   • 导航到 Gearmulator 项目目录：

     cd gearmulator
     

2. 生成项目文件：

   • 使用 CMake 生成 Visual Studio 项目文件：

     cmake -G "Visual Studio 16 2019" -A x64 .
     

3. 编译项目：

   • 打开生成的 Visual Studio 解决方案文件（gearmulator.sln）并编译项目。

4.2 macOS 安装

1. 打开终端：

   • 导航到 Gearmulator 项目目录：

     cd gearmulator
     

2. 生成项目文件：

   • 使用 CMake 生成 Xcode 项目文件：

     cmake -G "Xcode" .
     

3. 编译项目：

   • 打开生成的 Xcode 项目文件（gearmulator.xcodeproj）并编译项目。

4.3 Linux 安装

1. 打开终端：

   • 导航到 Gearmulator 项目目录：

     cd gearmulator
     

2. 生成项目文件：

   • 使用 CMake 生成 Makefile：

     cmake .
     

3. 编译项目：

   • 使用 make 命令编译项目：

     make
     

5. 项目处理脚本

Gearmulator 项目包含多个处理脚本，用于在不同平台上构建和配置项目。以下是一些常用的脚本：

• build_win64.bat：用于在 Windows 64 位系统上构建项目。
• build_mac.sh：用于在 macOS 上构建项目。
• build_linux.sh：用于在 Linux 上构建项目。

使用示例

在 Windows 上，你可以直接运行 build_win64.bat 脚本来构建项目：

build_win64.bat

在 macOS 或 Linux 上，你可以运行相应的 shell 脚本来构建项目：

./build_mac.sh

或

./build_linux.sh

通过这些步骤，你应该能够成功下载、配置和安装 Gearmulator 项目。