Profile
Back to NewsBack
GitHub Trending 2 min
Reader Mode
iPlug2/iPlug2OOS: Template monorepo to build an iPlug2 project with CI/CD

iPlug2/iPlug2OOS: Template monorepo to build an iPlug2 project with CI/CD

4 hours ago

Build Wasm</a>

This repo contains an "out of source" iPlug2 template project, which is desirable when you need to keep all your project dependencies synchronised with version control and build it using CI/CD in the cloud. It set up for "containerized development" using VSCode and github codespaces.

Instead of using the common-mac.xcconfig and common-win.xcconfig in the iPlug2 folder, it uses copies of them at the top level of the iPlug2OOS repo. This means the iPlug2 submodule itself does not have to be modified.

https://github.com/iPlug2/iPlug2/wiki/Out-of-source-builds

The iPlug2 submodule lives at modules/iPlug2. If you cloned the repo before it moved there from iPlug2/, run this after pulling:

git submodule sync && git submodule update --init

You can then delete the old top-level iPlug2/ folder.

Containerized development is documented here

CMake

The template can also be built with CMake on macOS, Windows, Linux and the web, using the presets in CMakePresets.json (cmake --list-presets).

Linux

Linux builds (standalone app, VST3 and CLAP) are CMake-only. On Ubuntu/Debian:

sudo apt-get install -y \
  build-essential cmake ninja-build pkg-config \
  libfreetype-dev libfontconfig-dev \
  libx11-dev libx11-xcb-dev libxcb1-dev libxi-dev libxext-dev libxrender-dev \
  libxrandr-dev libxfixes-dev libxcursor-dev \
  libgl-dev libgtk-3-dev \
  libasound2-dev libjack-jackd2-dev libpulse-dev

(cd modules/iPlug2/Dependencies/IPlug && ./download-iplug-sdks.sh)

cmake --preset linux-ninja cmake --build --preset linux-ninja

Binaries are written to build/linux-ninja/out/; the VST3 and CLAP are symlinked into ~/.vst3 and ~/.clap (disable with -DIPLUG_DEPLOY_PLUGINS=OFF). CMake 3.25 or later is required.

TemplateProject/scripts/makedist-linux.sh builds a release and packages it as a .tar.gz in TemplateProject/build-linux/out/; the Release Native workflow runs it and attaches the archive to the GitHub release.

Chat with me