Build an iPlug2 plugin project for different formats and platforms using xcodebuild or Visual Studio
The 'build' skill is designed to help users compile and build an iPlug2 plugin project across different platforms using tools like xcodebuild on macOS or Visual Studio on Windows. This skill simplifies the process of building a plugin by providing clear instructions for each platform, helping users avoid common issues in the build process and ensuring the project is set up correctly for different formats. It supports a variety of plugin formats including VST2, VST3, AU, CLAP, AAX, and more, making it a versatile tool for developers working with iPlug2 projects on multiple operating systems.
The skill offers detailed commands for building the project on macOS, iOS, and Windows, with specific configurations for each platform. For macOS, it allows users to build using xcodebuild and targets various formats such as APP, VST3, and AU. The iOS build command is tailored to the AUv3App target, while Windows users can leverage Visual Studio's build tools with the msbuild command. Additionally, the skill provides guidance for managing build locations and using Xcode for debugging. The 'build' skill is especially useful for iPlug2 developers who need to compile their projects for different platforms without having to manually adjust complex settings.
This skill is ideal for developers creating audio plugins using the iPlug2 framework. It's tailored for users who want a streamlined, reliable way to compile their plugin projects for multiple platforms. Whether you're building for macOS, iOS, or Windows, this skill provides the necessary tools to get your plugin up and running quickly. It's particularly beneficial for developers new to iPlug2 or audio plugin development, as it simplifies the often complex process of setting up and troubleshooting builds across different systems and plugin formats.
Use the 'xcodebuild' command to build your plugin on macOS. Navigate to your project folder and run the following command: 'xcodebuild -project './projects/[ProjectName]-macOS.xcodeproj' -target [TARGET] -configuration [CONFIG]'. Make sure to specify the correct target and configuration, and check the 'build_errors.log' file for any issues.
The recommended configurations for macOS builds are 'Debug', 'Release', and 'Tracer'. The 'Release' configuration is typically used for final builds, while 'Debug' is useful during development. 'Tracer' can be used for debugging purposes to track issues.
It is recommended to build one target at a time to avoid issues with missing SDKs. Attempting to build multiple targets at once, such as using the 'All' option, may lead to build failures if required SDKs are not present.
The skill supports building plugins for macOS, iOS, and Windows. For macOS, you can use xcodebuild with targets like APP, AU, VST3, and more. For iOS, the AUv3App target is supported. Windows users can build using Visual Studio and msbuild.
For iOS builds, the AUv3App target is required as it packages the plugin as an App Extension. However, for new users, it is recommended to use AUv2 instead of AUv3 due to its simpler setup process.
Quick Setup:
.claude/skills/Repository
iPlug2/iPlug2