Build iPlug2 Plugin

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

macOS Build (xcodebuild)

cd [ProjectFolder]
xcodebuild -project "./projects/[ProjectName]-macOS.xcodeproj" -target [TARGET] -configuration [CONFIG] 2> ./build_errors.log

Targets: APP, AU, VST2, VST3, CLAP, AAX, AUv3, AUv3App, All Configurations: Debug, Release, Tracer

Build Locations (from common-mac.xcconfig)

• 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 ./[ProjectName].xcworkspace

iOS Build

xcodebuild -project "./projects/[ProjectName]-iOS.xcodeproj" -target AUv3App -configuration Release

Windows Build

Open the .sln file in Visual Studio:

[ProjectName].sln

Build from IDE or command line:

msbuild [ProjectName].sln /p:Configuration=Release /p:Platform=x64

Tips

• Build one target at a time; All may fail if SDKs are missing
• Check build_errors.log for issues
• AUv3 requires building AUv3App target (packages plugin as App Extension)
• Recommend AUv2 over AUv3 for new users (simpler setup)