| name | build-cmake |
| description | Build an iPlug2 plugin project using CMake with Ninja, Xcode, or Visual Studio generators |
Build iPlug2 Plugin with CMake
Use this skill when the user wants to build their plugin project using CMake.
Prerequisites
- CMake 3.14+
- Ninja (recommended) or Xcode/Visual Studio
- Plugin SDKs downloaded (VST3, CLAP, etc.) via
/setup-deps
Quick Start
cd [ProjectFolder]
mkdir -p build && cd build
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
Generators
| Generator | Command | Platform | Notes |
|---|
| Ninja | -G Ninja | macOS, Windows | Fast, recommended |
| Xcode | -G Xcode | macOS, iOS, visionOS | Multi-config, good for debugging |
| Visual Studio | -G "Visual Studio 17 2022" -A x64 | Windows | Multi-config |
Build Commands
Configure (choose one):
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
cmake -G Xcode ..
cmake -G "Visual Studio 17 2022" -A x64 ..
Build all targets:
cmake --build . --config Release
Build specific target:
cmake --build . --config Release --target [PluginName]-vst3
Target Suffixes
| Format | Target Suffix |
|---|
| Standalone App | -app |
| VST2 | -vst2 |
| VST3 | -vst3 |
| CLAP | -clap |
| AAX | -aax |
| AUv2 | -au |
Common Options
-DCMAKE_BUILD_TYPE=Debug
-DCMAKE_BUILD_TYPE=Release
-DIPLUG2_UNIVERSAL=ON
-DIGRAPHICS_BACKEND=SKIA -DIGRAPHICS_RENDERER=METAL
-DIPLUG2_DEBUG_HOST="/Applications/REAPER.app"
Platform-Specific
iOS Device:
cmake -G Xcode -DCMAKE_SYSTEM_NAME=iOS -DIPLUG2_IOS_PLATFORM=OS ..
iOS Simulator:
cmake -G Xcode -DCMAKE_SYSTEM_NAME=iOS -DIPLUG2_IOS_PLATFORM=SIMULATOR ..
visionOS:
cmake -G Xcode -DCMAKE_SYSTEM_NAME=iOS -DIPLUG2_IOS_PLATFORM=VISIONOS ..
Web (Emscripten):
emcmake cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
cmake --build . --target [PluginName]-wam
Build Output
Output goes to build/out/:
[PluginName].app - Standalone
[PluginName].vst3/ - VST3
[PluginName].clap/ - CLAP
[PluginName].component/ - AUv2
[PluginName].aaxplugin/ - AAX
Workflow
-
Ask for build preferences:
- Generator (Ninja/Xcode/VS)
- Configuration (Debug/Release)
- Specific target or all
- IGraphics backend if relevant
-
Configure if needed (only once per build directory)
-
Build the requested target(s)
-
Report output location from build/out/
Tips
- Ninja is fastest for iterative development
- Xcode generator required for Swift examples (IPlugSwiftUI, IPlugCocoaUI)
- Use
--target to build specific formats and avoid SDK-related failures
- Check Documentation/cmake.md for full reference