build
Build an iPlug2 plugin project for different formats and platforms (macOS, iOS, Windows)
When & Why to Use This Skill
This Claude skill automates the build process for iPlug2 audio plugin projects across multiple platforms, including macOS, iOS, and Windows. It streamlines the compilation of various industry-standard formats such as VST3, AU, AAX, and CLAP by handling workspace identification, scheme selection, and environment-specific build commands, significantly reducing the manual overhead for audio software developers.
Use Cases
- Cross-Platform Plugin Compilation: Automatically build and package VST3, AU, and CLAP formats on macOS using xcodebuild for streamlined distribution.
- iOS Audio App Development: Compile 'iOS-APP with AUv3' schemes and prepare projects for testing within the iOS Simulator environment.
- Windows Build Automation: Execute msbuild commands to generate 64-bit Windows plugin binaries directly from project solution files.
- Continuous Development Workflow: Quickly verify code changes by triggering automated builds and monitoring build logs for errors without leaving the agent interface.
| 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
.xcworkspacefiles in the repo root (excluding TemplateProject) - Ask user to choose if multiple projects exist
- If not specified, look for
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.logfor issues - If Skia backend is configured, run
iPlug2/Dependencies/download-prebuilt-libs.sh macfirst - AUv3 requires code signing; use
macOS-AU(AUv2) for simpler local testing - Use
xcodebuild -workspace [Project]/[Project].xcworkspace -listto see all available schemes
Example
# Build standalone app (Debug)
xcodebuild -workspace MySynth/MySynth.xcworkspace -scheme "macOS-APP" -configuration Debug build
# Open the built app
open ~/Applications/MySynth.app
# Build AU plugin (Release)
xcodebuild -workspace MySynth/MySynth.xcworkspace -scheme "macOS-AU" -configuration Release build