v1

Hello world!

This is our first official release of setup-sdl!

The problem

You want to build your app that uses Simple Directmedia Layer on GitHub Actions, but it's unclear how to get SDL installed on most of the VMs. The one that's easy (apt-get on Ubuntu) installs a very old version of SDL. Usually you end up not using GitHub Actions, or building only on the Ubuntu VMs.

The solution

We have provided setup-sdl, which you can slot into your GitHub Actions workflow with a few lines of text, and it'll provide your desired version of SDL2 or SDL3 automatically, so it's available by the time you build your own code.

The first time setup-sdl runs, it will compile SDL for the platform. It then caches it, so future runs are near-instantaneous, getting right to your code.

For example, here's our own SDL_image library, using setup-sdl in its CI to get the bleeding edge of SDL3 development:

About 8 lines of YAML.

Here's another example, that's about the easiest way to guarantee a stable release of SDL2 is available everywhere GitHub Actions runs, using the new v1 tag:

FIVE lines of YAML!

We think this will make it super-nice to build SDL apps and libraries on GitHub Actions.

Enjoy!