Build iPlug2 Plugin (iPlug2OOS)

Use this skill when the user wants to build their plugin project.

Workflow

1. Identify the project:

   • If not specified, look for .xcworkspace files in the repo root (excluding TemplateProject)
   • Ask user to choose if multiple projects exist

2. 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

# 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