Build iPlug2 Plugin
Use this skill when the user wants to build their plugin project.
macOS Build (xcodebuild)
bash
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)
bash
open ./[ProjectName].xcworkspace
iOS Build
bash
xcodebuild -project "./projects/[ProjectName]-iOS.xcodeproj" -target AUv3App -configuration Release
Windows Build
Open the .sln file in Visual Studio:
code
[ProjectName].sln
Build from IDE or command line:
cmd
msbuild [ProjectName].sln /p:Configuration=Release /p:Platform=x64
Tips
- •Build one target at a time;
Allmay fail if SDKs are missing - •Check
build_errors.logfor issues - •AUv3 requires building
AUv3Apptarget (packages plugin as App Extension) - •Recommend AUv2 over AUv3 for new users (simpler setup)