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