Build Theos projects (usually iOS tweaks) with GitHub Actions easily.

Theos is a cross-platform building suite for iOS and MacOS. It's mainly used for developing and compiling jailbroken iOS tweaks for the iPhone/iPad.

Theos is a bit of a pain to set up sometimes. It requires quite a few dependencies, and it takes a considerable amount of storage space. It's not easy to set up manually in a CI workflow. That's where this comes in! Additionally, this allows people to build their tweaks without having to install Xcode on their own machine, or even without a computer at all!

You must use a MacOS or Linux runner. Windows is not supported, and probably never will be.

- uses: Randomblock1/theos-action@v1
  with:
    # All of these are optional. Defaults are filled in below.
    
    # This is where Theos is downloaded to.
    theos-dir: 'theos'
    
    # This is where Theos will be git cloned from.
    theos-src: 'https://github.com/theos/theos'
    
    # This is where the Theos SDKs will be downloaded from.
    # Useful for using frameworks that aren't in the official repo.
    theos-sdks: 'https://github.com/theos/sdks'

    # Which branch to clone from theos-sdks repo.
    theos-sdks-branch: 'master'

See this workflow as an example of how to use this. It configures a custom SDK repository, uses GitHub Actions cache to speed up downloads (Theos and the SDKs are rarely updated), builds a tweak, and packages it up using GitHub Artifacts.

That workflow should work out-of-the-box for most Theos projects. Some tweaking is required, but it's basically just copy-paste.

This project is released under the MIT License.