| name | build |
| description | Build an iPlug2 plugin project for different formats and platforms (macOS, iOS, Windows) |
Build iPlug2 Plugin (iPlug2OOS)
Use this skill when the user wants to build their plugin project.
Workflow
-
Identify the project:
- If not specified, look for
.xcworkspace files in the repo root (excluding TemplateProject)
- Ask user to choose if multiple projects exist
-
Build using the appropriate method below
macOS Build (xcodebuild)
xcodebuild -workspace [Project]/[Project].xcworkspace -scheme "[SCHEME]" -configuration [CONFIG] build 2>&1 | tee build.log
Schemes: macOS-APP, macOS-AU, macOS-VST2, macOS-VST3, macOS-CLAP, macOS-AAX, macOS-AUv3
Configurations: Debug, Release, Tracer
Build Locations
- APP:
~/Applications/[PluginName].app
- VST3:
~/Library/Audio/Plug-Ins/VST3/
- AU:
~/Library/Audio/Plug-Ins/Components/
- CLAP:
~/Library/Audio/Plug-Ins/CLAP/
Open in Xcode (recommended for debugging)
open [Project]/[Project].xcworkspace
iOS Build
xcodebuild -workspace [Project]/[Project].xcworkspace -scheme "iOS-APP with AUv3" -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 16 Pro' build
For running in Simulator, use the run-ios-simulator skill.
Windows Build
Open the .sln file in Visual Studio:
[Project]/[Project].sln
Build from IDE or command line:
msbuild [Project]/[Project].sln /p:Configuration=Release /p:Platform=x64
Tips
- Build one scheme at a time; building all may fail if SDKs are missing
- Check
build.log for issues
- If Skia backend is configured, run
iPlug2/Dependencies/download-prebuilt-libs.sh mac first
- AUv3 requires code signing; use
macOS-AU (AUv2) for simpler local testing
- Use
xcodebuild -workspace [Project]/[Project].xcworkspace -list to see all available schemes
Example
xcodebuild -workspace MySynth/MySynth.xcworkspace -scheme "macOS-APP" -configuration Debug build
open ~/Applications/MySynth.app
xcodebuild -workspace MySynth/MySynth.xcworkspace -scheme "macOS-AU" -configuration Release build
